Spring Boot Auto-Configuration 순서 의존성 문제

Spring Boot Auto-Configuration
김주혁's avatar
Jun 19, 2026
Spring Boot Auto-Configuration 순서 의존성 문제

증상


spring-boot-starter-web을 통해 Jackson 라이브러리와 ObjectMapper 자동 구성이 정상적으로 포함돼 있음에도 다음 오류로 애플리케이션 기동이 실패했습니다.
Required error handler delegate is missing: rabbit
Rabbit ErrorHandler 생성 과정을 역추적하면 다음과 같습니다.
 
RabbitMqAutoConfiguration에서 RabbitPublisher는 다음 조건을 만족해야 생성됩니다.
@ConditionalOnBean({ RabbitTemplate.class, ObjectMapper.class, RabbitMqNamingResolver.class })
  • RabbitTemplate
  • ObjectMapper
  • RabbitMqNamingResolver 필요
 
하지만 조건 평가 시점에 ObjectMapper Bean이 아직 등록되지 않아 RabbitPublisher가 생성 대상에서 제외됐습니다. 그 결과 후속 Bean인 rabbitErrorHandlerDelegate도 생성되지 않았고, 최종적으로 routingErrorHandler 생성이 실패했습니다.
 
애플리케이션에 ObjectMapper Bean을 직접 등록했을 때 정상 기동된 이유도 사용자 정의 Bean이 자동 구성보다 먼저 등록되어 @ConditionalOnBean 조건을 만족시켰기 때문입니다.

원리


 
Spring Boot Auto-Configuration은 클래스패스에 클래스가 존재하는지와 Spring 컨테이너에 Bean이 등록돼 있는지를 별도로 판단합니다.
@ConditionalOnClass(ObjectMapper.class)
이 조건은 Jackson 라이브러리가 클래스패스에 존재하는지만 확인합니다.
반면 다음 조건은 평가 시점에 Spring Bean 정의가 실제로 등록돼 있어야 합니다.
@ConditionalOnBean(ObjectMapper.class)
이번 환경에는 jackson-module-parameter-names와 jackson-databind가 컴파일 및 런타임 클래스패스에 정상 포함돼 있었습니다. 따라서 의존성 누락이 아니라 Bean 등록 시점의 문제였습니다.
 
ObjectMapper는 JacksonAutoConfiguration에서 생성되고, RabbitPublisher는 사내 라이브러리의 RabbitMqAutoConfiguration에서 생성됩니다. 두 자동 구성 사이에 실행 순서가 명시되지 않으면 Rabbit 구성이 Jackson 구성보다 먼저 조건을 평가할 수 있습니다.
조건 평가 시 ObjectMapper Bean이 없으면 해당 Bean 메서드는 자동 구성 대상에서 제외됩니다. 이후 Jackson 자동 구성이 ObjectMapper를 생성하더라도 이미 제외된 RabbitPublisher가 다시 평가되지는 않습니다.

해결


 
라이브러리의 RabbitMqAutoConfiguration이 Spring Boot의 Rabbit 및 Jackson 자동 구성 이후에 처리되도록 순서를 명시했습니다.
@AutoConfiguration @AutoConfigureAfter({ RabbitAutoConfiguration.class, JacksonAutoConfiguration.class }) public class RabbitMqAutoConfiguration { }
이를 통해 다음 순서가 보장됩니다.
  • JacksonAutoConfiguration → ObjectMapper Bean 등록
  • RabbitAutoConfiguration → RabbitTemplate Bean 등록
  • RabbitMqAutoConfiguration
    • 조건 충족
    • RabbitPublisher 생성
    • RabbitErrorHandlerDelegate 생성
    • RoutingErrorHandler 생성
애플리케이션에서 아래처럼 ObjectMapper를 직접 등록하는 방법도 임시 해결책은 될 수 있습니다.
@Bean public ObjectMapper objectMapper() { return new ObjectMapper(); }
하지만 이 방식은 Spring Boot가 적용하는 Jackson 설정, Java Time 모듈, 직렬화 옵션 및 사용자 정의 모듈을 누락시킬 수 있습니다.
 
또한 자동 구성 라이브러리의 순서 결함을 사용하는 애플리케이션이 대신 보완하게 됩니다.
Share article