빈 후처리기가 받는 빈은 그 후처리기를 거치지 못한다

설정 클래스가 직접 빈으로 등록하는 v1·v2와 달리 컴포넌트 스캔으로 올라가는 v3에도 프록시(실제 객체 대신 호출을 받아 앞뒤에 기능을 붙이는 객체)를 붙이려고 앞 편의 ProxyFactory 설정 대신 스프링 빈 후처리기(BeanPostProcessor, 스프링이 만든 빈 객체를 등록 전에 받아 고치거나 다른 객체로 바꿔 돌려주는 객체)를 등록하면, Spring Boot 4.1 앱의 시작 로그에 강의에서 다루지 않은 WARN 세 줄이 찍힌다. BeanPostProcessorChecker가 빈 세 개를 두고 모든 빈 후처리기의 처리를 받을 수 없다(not eligible for getting processed by all BeanPostProcessors)고 남긴 경고다. 그래도 프록시가 필요한 빈 9개(v1·v2·v3 세 버전의 컨트롤러·서비스·리포지토리)는 모두 프록시가 됐고, 주문 요청마다 추적 로그도 계층마다 시작과 끝을 찍어 6줄씩 정상으로 찍혔다

빈 후처리기는 다른 빈보다 먼저 만들어지므로, 후처리기를 만드는 데 필요한 빈도 그때 함께 만들어져 그 후처리기를 거치지 못한다. 강의 코드에서는 후처리기 @Bean 메서드가 static이 아니어서 그 메서드를 가진 설정 클래스가, 메서드가 인자로 받는 로그 추적기 LogTrace(요청 하나의 호출을 같은 ID로 묶어 깊이대로 들여 찍는 빈)와 그 빈을 등록한 메인 클래스가 그렇다. Spring Framework 5.x와 6.0은 이를 INFO로 남겼고 6.1부터 WARN으로 알린다(gh-24092). 후처리기 @Bean 메서드를 static으로 바꾸면 설정 클래스 줄이 빠지고, LogTrace와 메인 클래스 두 줄은 남는다

이 앱에서 경고에 나온 빈은 원래 프록시가 필요 없는 빈이라 실제 피해는 없다. 자기 앱에서 같은 경고를 보면, 이름이 나온 빈이 프록시나 다른 후처리가 필요한 빈인지부터 확인한다

후처리기 @Bean이 static이 아니면 설정 클래스가 먼저 만들어져 그 후처리기를 건너뛴다

강의는 BeanPostProcessor를 구현해 빈으로 등록하기만 하면 후처리기가 동작하고, 후처리기가 다른 빈보다 먼저 등록되므로 어느 설정 클래스에 두어도 상관없다고 설명한다. 지금도 그 순서대로 동작한다. 레퍼런스 문서는 여기서 더 나아가, 후처리기와 후처리기가 직접 참조하는 빈은 컨텍스트 시작의 특별한 단계에서 먼저 만들어지고 이 단계에서 만들어진 빈은 모든 후처리기의 처리를 온전히 받지 못한다고 적는다(Customizing Beans by Using a BeanPostProcessor — Spring Framework 7.0). 먼저 만들어지는 것이 후처리기 하나로 끝나지 않는다는 뜻이다

후처리기 하나만 둔 테스트에서 이것이 보인다. 설정 클래스가 빈 beanA로 A를 등록하고, A를 받으면 B로 바꿔 돌려주는 후처리기도 함께 등록한다. 후처리기는 받은 빈마다 이름을 로그로 남긴다

@Configuration
static class BeanPostProcessorConfig {
    @Bean(name = "beanA")
    public A a() {
        return new A();
    }

    @Bean
    public AToBPostProcessor helloPostProcessor() {
        return new AToBPostProcessor();
    }
}

@Slf4j
static class AToBPostProcessor implements BeanPostProcessor {

    @Override
    public @Nullable Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
        log.info("beanName={} bean={}", beanName, bean);
        if (bean instanceof A) {
            return new B();
        }
        return bean;
    }
}

helloPostProcessor()는 인스턴스 메서드라서, 스프링은 이 메서드를 부르려고 BeanPostProcessorConfig 객체부터 만든다. 설정 클래스가 후처리기보다 먼저 만들어지니 그 후처리기를 거칠 수 없다. 이 테스트를 돌린 로그다(이 테스트의 로그 형식에는 수준이 찍히지 않는다)

18:13:08.071 [Test worker] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'basicPostProcessorTest.BeanPostProcessorConfig' of type [hello.advanced.proxy.postprocessor.BasicPostProcessorTest$BeanPostProcessorConfig$$SpringCGLIB$$0] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). The currently created BeanPostProcessor [helloPostProcessor] is declared through a non-static factory method on that class; consider declaring it as static instead.
18:13:08.100 [Test worker] BasicPostProcessorTest$AToBPostProcessor : beanName=beanA bean=hello.advanced.proxy.postprocessor.BasicPostProcessorTest$A@771cbb1a
18:13:08.108 [Test worker] BasicPostProcessorTest$B : hello B

후처리기가 받은 빈은 beanA 하나뿐이고, 첫 줄의 경고는 바로 그 설정 클래스를 가리키며 후처리기를 static으로 선언하라고 권한다. @Bean 메서드에 static만 붙여 다시 돌린 로그다

18:13:10.088 [Test worker] BasicPostProcessorTest$AToBPostProcessor : beanName=basicPostProcessorTest.BeanPostProcessorConfig bean=hello.advanced.proxy.postprocessor.BasicPostProcessorTest$BeanPostProcessorConfig$$SpringCGLIB$$0@514cd540
18:13:10.093 [Test worker] BasicPostProcessorTest$AToBPostProcessor : beanName=beanA bean=hello.advanced.proxy.postprocessor.BasicPostProcessorTest$A@2cec704c
18:13:10.107 [Test worker] BasicPostProcessorTest$B : hello B

경고가 사라지고, 후처리기가 beanA보다 앞서 설정 클래스도 받았다. static 메서드는 설정 클래스 객체 없이 부를 수 있어서, 설정 클래스가 다른 빈처럼 후처리기가 등록된 뒤에 만들어졌다. 두 경우 모두 beanA 이름으로 B가 등록돼 테스트는 통과했다

후처리기가 인자로 받는 LogTrace도 먼저 만들어져 그 후처리기를 지나지 못한다

강의 앱은 같은 주문 기능을 세 가지로 만들어 둔다. v1은 인터페이스와 구현 클래스, v2는 인터페이스 없는 클래스이고 둘 다 설정 클래스가 직접 빈으로 등록하며, v3는 컴포넌트 스캔으로 등록된다. 후처리기 PackageLogTracePostProcessor는 이 세 버전이 있는 패키지의 빈만 프록시로 바꾼다. 프록시에 넣을 어드바이저(어디에 적용할지 정하는 포인트컷과 무엇을 할지 정하는 어드바이스를 묶은 것)는 설정 클래스가 만들어 생성자로 넘기고, 그 어드바이스가 LogTrace를 쓴다. LogTrace는 1편에서 만든 추적기다. 이 빈은 메인 클래스가 등록한다

@Configuration
@Import({AppV1Config.class, AppV2Config.class})
public class BeanPostProcessorConfig {

    @Bean
    public PackageLogTracePostProcessor logTracePostProcessor(LogTrace logTrace) {
        return new PackageLogTracePostProcessor("hello.advanced.proxy.app", getAdvisor(logTrace));
    }

    private Advisor getAdvisor(LogTrace logTrace) {
        // ... 메서드 이름 포인트컷(request*, order*, save*)과 new LogTraceAdvice(logTrace)를 묶어 돌려준다
    }
}

@Import(BeanPostProcessorConfig.class)
@SpringBootApplication(scanBasePackages = "hello.advanced.proxy.app")
public class AdvancedApplication {
    // ...
    @Bean
    public LogTrace logTrace() {
        return new ThreadLocalLogTrace();
    }
}

이 앱을 띄운 시작 로그에서 WARN 이상만 따로 남긴 파일이다. 세 줄이 전부다

18:13:12.731 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'hello.advanced.proxy.config.v4_postprocessor.BeanPostProcessorConfig' of type [hello.advanced.proxy.config.v4_postprocessor.BeanPostProcessorConfig$$SpringCGLIB$$0] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). The currently created BeanPostProcessor [logTracePostProcessor] is declared through a non-static factory method on that class; consider declaring it as static instead.
18:13:12.732 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'advancedApplication' of type [hello.advanced.AdvancedApplication$$SpringCGLIB$$0] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). Is this bean getting eagerly injected/applied to a currently created BeanPostProcessor [logTracePostProcessor]? Check the corresponding BeanPostProcessor declaration and its dependencies/advisors. If this bean does not have to be post-processed, declare it with ROLE_INFRASTRUCTURE.
18:13:12.733 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'logTrace' of type [hello.advanced.trace.logtrace.ThreadLocalLogTrace] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). Is this bean getting eagerly injected/applied to a currently created BeanPostProcessor [logTracePostProcessor]? Check the corresponding BeanPostProcessor declaration and its dependencies/advisors. If this bean does not have to be post-processed, declare it with ROLE_INFRASTRUCTURE.

세 줄 모두 대괄호 안의 logTracePostProcessor를 만드는 동안 만들어진 빈이다. 첫 줄은 앞의 테스트와 같은 종류의 경고로, 이름이 같은 앱의 설정 클래스 BeanPostProcessorConfig를 가리킨다. 둘째 줄은 LogTrace 빈을 등록한 메인 클래스 advancedApplication, 셋째 줄은 후처리기가 인자로 받는 logTrace다. 후처리기를 만들려면 logTrace()를 불러야 하고, 이 메서드도 인스턴스 메서드라 메인 클래스 객체가 먼저 있어야 한다

이 줄을 남기는 BeanPostProcessorChecker는 스프링이 후처리기를 등록하기 직전에 넣어 두는 감시용 후처리기로, 후처리기 등록이 모두 끝나기 전에 만들어진 빈을 볼 때마다(후처리기 자신과 ROLE_INFRASTRUCTURE 빈은 빼고) 한 줄씩 남긴다(PostProcessorRegistrationDelegate — Spring Framework 7.0.9 소스). 6.1에서 WARN으로 올리며 원인과 대처를 짚는 문장을 붙였다(gh-24092). 그 앞 버전으로 띄워 보지는 않았다

PackageLogTracePostProcessor도 받은 빈마다 이름을 한 줄씩 남기는데, 이 실행에서 경고에 나온 세 빈의 이름은 한 번도 나오지 않아 경고대로 이 후처리기를 지나지 않았다. 그래도 프록시가 필요한 v1·v2·v3의 컨트롤러·서비스·리포지토리 9개는 모두 프록시가 됐다. v1은 인터페이스를 구현해 만드는 JDK 동적 프록시, v2·v3는 클래스를 상속해 만드는 CGLIB 프록시다. v1·v2·v3의 주문 요청은 추적 로그가 6줄씩 찍혔고, 추적을 붙이지 않는 noLog() 요청은 포인트컷이 request*·order*·save* 이름만 잡아서 0줄이다. 프록시로 바뀐 v1·v2 컨트롤러가 200인 것은, 타입에 @RequestMapping만 붙어 Spring 6.0부터 컨트롤러로 잡히지 않는 v1·v2를 컨트롤러로 보게 넓힌 isHandler() 확장 빈(앞 편의 WebMvcRegistrations)이 그대로 있어서다

static으로 바꿔도 후처리기가 받는 빈의 경고는 남는다

@Bean Javadoc은 후처리기를 돌려주는 @Bean 메서드를 static으로 선언하라고 권한다. 설정 클래스 객체 없이 부를 수 있어서다. 되도록 다른 빈을 인자로 받지 말라는 말도 붙는데, 받는 빈도 후처리기를 만들려고 먼저 만들어야 하기 때문이다(Bean — Spring Framework 7 API). 강의 코드에서 static은 바로 붙일 수 있지만, LogTrace는 어드바이스가 쓰는 빈이라 인자에서 그냥 뺄 수 없다

후처리기 @Bean 메서드에 static을 붙였다. 이 메서드가 부르는 getAdvisor()도 static이어야 컴파일된다

@Bean
public static PackageLogTracePostProcessor logTracePostProcessor(LogTrace logTrace) {
    return new PackageLogTracePostProcessor("hello.advanced.proxy.app", getAdvisor(logTrace));
}

private static Advisor getAdvisor(LogTrace logTrace) {
    // ...
}

이렇게 바꿔 띄운 시작 로그의 WARN 줄이다

18:13:19.892 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'advancedApplication' of type [hello.advanced.AdvancedApplication$$SpringCGLIB$$0] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). Is this bean getting eagerly injected/applied to a currently created BeanPostProcessor [logTracePostProcessor]? Check the corresponding BeanPostProcessor declaration and its dependencies/advisors. If this bean does not have to be post-processed, declare it with ROLE_INFRASTRUCTURE.
18:13:19.894 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'logTrace' of type [hello.advanced.trace.logtrace.ThreadLocalLogTrace] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). Is this bean getting eagerly injected/applied to a currently created BeanPostProcessor [logTracePostProcessor]? Check the corresponding BeanPostProcessor declaration and its dependencies/advisors. If this bean does not have to be post-processed, declare it with ROLE_INFRASTRUCTURE.

설정 클래스 줄이 빠지고 advancedApplication과 logTrace 두 줄이 남았다. 후처리기 로그에는 이제 설정 클래스 이름이 나오고, 남은 두 빈의 이름은 여전히 없다

남은 두 줄을 두고, static은 그대로 둔 채 두 가지를 더 바꿔 띄웠다. 하나는 LogTrace 인자에 @Lazy를 붙였다. 주입 지점의 @Lazy는 실제 빈 대신, 처음 쓸 때 실제 빈을 찾아오는 지연 조회 프록시를 넣는다(Lazy — Spring Framework 7 API). 다른 하나는 경고 문구가 권하는 대로 logTrace @Bean에 @Role(BeanDefinition.ROLE_INFRASTRUCTURE)를 붙였다. 사용자와 상관없는 내부용 빈이라는 표시다(BeanDefinition.ROLE_INFRASTRUCTURE — Spring Framework 7 API)

네 조건을 나란히 놓았다. 경고는 조건마다 WARN 이상만 남긴 파일에서, 후처리기를 지나지 않은 빈은 일찍 만들어질 수 있는 세 빈 가운데 후처리기 로그에 이름이 없는 빈으로 셌다. 표의 설정 클래스는 BeanPostProcessorConfig다

조건WARN 줄경고에 나온 빈후처리기를 지나지 않은 빈
강의 코드 그대로3설정 클래스, advancedApplication, logTrace설정 클래스, advancedApplication, logTrace
static2advancedApplication, logTraceadvancedApplication, logTrace
static + @Lazy0없음없음
static + ROLE_INFRASTRUCTURE1advancedApplicationadvancedApplication, logTrace

ROLE_INFRASTRUCTURE를 붙인 조건을 빼면, 경고에 나온 빈과 후처리기를 지나지 않은 빈이 같다. @Lazy 조건은 후처리기를 만들 때 실제 LogTrace 대신 지연 조회 프록시만 넣으면 되니 LogTrace와 메인 클래스를 먼저 만들 필요가 없어진 것으로 보이고, 경고가 후처리기를 만들 때 필요한 빈을 따라 움직인다는 대조가 된다. 다만 공식 문서가 후처리기에 권하는 것은 static과 의존성 줄이기까지이고, @Lazy Javadoc도 지연 조회 프록시를 만드는 주입 지점으로 @Autowired·@Inject만 적는다. @Bean 메서드 인자에서 이렇게 동작한 것은 이 실행의 관측으로만 둔다

ROLE_INFRASTRUCTURE는 logTrace 줄만 지웠고, 표에서 보듯 logTrace는 여전히 후처리기를 지나지 않았다. 앞에서 본 대로 BeanPostProcessorChecker는 이 표시가 붙은 빈을 경고에서 뺄 뿐이고, 경고 문구도 후처리가 필요 없는 빈일 때 붙이라고 조건을 단다. 이 방법은 레퍼런스와 @Bean Javadoc에는 없고 경고 문구에만 나온다. advancedApplication 줄은 logTrace()를 부르려면 메인 클래스 객체가 먼저 있어야 해서 그대로 남았다

자동 프록시 생성기로 바꾸면 이 앱에서는 경고가 사라진다

스프링이 제공하는 자동 프록시 생성기(AnnotationAwareAspectJAutoProxyCreator)는 빈으로 등록된 어드바이저를 모두 찾아 포인트컷에 맞는 빈을 프록시로 바꾸는 빈 후처리기라, 후처리기를 직접 만들어 등록할 필요가 없다. Boot는 AspectJ 라이브러리가 클래스패스에 있으면 이 생성기를 자동으로 켠다(Aspect-Oriented Programming — Spring Boot 4.1). 강의는 이를 위해 spring-boot-starter-aop를 추가하라고 하는데, 이 스타터는 Boot 4.0에서 spring-boot-starter-aspectj로 이름이 바뀌었다(Spring Boot 4.0 Migration Guide — AOP Starter POM). 옛 이름으로 빌드하면 의존성을 찾지 못해 멈춘다

> Could not resolve all files for configuration ':compileClasspath'.
   > Could not find org.springframework.boot:spring-boot-starter-aop:.

설정 클래스에는 어드바이저 빈만 둔다. advisor3는 패키지 아래 모든 메서드에서 noLog()만 빼는 AspectJ 표현식 포인트컷을 쓰고, 이것도 LogTrace를 인자로 받는다

@Bean
public Advisor advisor3(LogTrace logTrace) {
    AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut();
    pointcut.setExpression(
        "execution(* hello.advanced.proxy.app..*(..)) && !execution(* hello.advanced.proxy.app..noLog(..))");
    LogTraceAdvice advice = new LogTraceAdvice(logTrace);
    return new DefaultPointcutAdvisor(pointcut, advice);
}

이 코드로 띄우면 WARN이 한 줄도 없다. 자동 프록시 생성기는 어드바이저를 빈을 만들 때마다 컨테이너에서 찾아 쓰므로 생성기를 만드는 데 advisor3나 LogTrace가 필요 없다. 경고가 없으니 이 앱에서는 두 빈이 후처리기 등록이 끝난 뒤에 만들어진 것이다. 프록시가 된 빈 9개와 추적 로그 줄 수(주문 요청 6줄, noLog() 요청 0줄)는 직접 만든 후처리기 때와 같았다

그렇다고 자동 프록시 생성기를 쓰면 이 경고가 나지 않는다고까지 말할 수는 없다. 이 코드에 아무 빈도 받지 않고 아무 일도 하지 않는 후처리기 plainPostProcessor를 static @Bean으로 하나 더하자 WARN 4줄이 나왔다. 경고에 나온 빈은 AutoProxyConfig(advisor3를 선언한 설정 클래스), advancedApplication, logTrace, advisor3이고, 네 줄 모두 대괄호 안이 [plainPostProcessor]다. 그중 advisor3 줄이다

18:13:47.917 WARN  [main] PostProcessorRegistrationDelegate$BeanPostProcessorChecker : Bean 'advisor3' of type [org.springframework.aop.support.DefaultPointcutAdvisor] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). Is this bean getting eagerly injected/applied to a currently created BeanPostProcessor [plainPostProcessor]? Check the corresponding BeanPostProcessor declaration and its dependencies/advisors. If this bean does not have to be post-processed, declare it with ROLE_INFRASTRUCTURE.

plainPostProcessor는 이 빈들을 받지 않는다. 스프링은 registerBeanPostProcessors()에서 후처리기를 PriorityOrdered, Ordered(둘 다 순서를 정하는 인터페이스), 나머지 순서로 만들어 등록하므로, Ordered인 자동 프록시 생성기가 plainPostProcessor보다 먼저 등록된다. 등록된 생성기는 빈을 만들기 직전마다 shouldSkip()을 부르고(AbstractAutoProxyCreator — Spring Framework 7.0.9 소스), 부모 클래스의 이 메서드가 어드바이저 빈을 찾아 가져온다(AspectJAwareAdvisorAutoProxyCreator — Spring Framework 7.0.9 소스). 그래서 plainPostProcessor를 만들기 직전에 advisor3와 그 인자인 LogTrace, 둘을 선언한 AutoProxyConfig·메인 클래스가 함께 만들어진 것으로 보인다. 경고 문구가 그 의존성과 어드바이저를 확인하라고 하는 것과 맞는다

순서 지정이 없는 후처리기라고 모두 이렇게 되지는 않는다. 이 앱에도 생성기보다 늦게 만들어지는 Boot 후처리기 webServerFactoryCustomizerBeanPostProcessor와 errorPageRegistrarBeanPostProcessor가 있지만, Boot는 이 둘을 synthetic(프레임워크가 내부용으로 만든 빈 정의라는 표시)으로 등록하고(ServletWebServerConfiguration — Spring Boot 4.1.1 소스), 스프링은 synthetic 빈에는 생성 직전(resolveBeforeInstantiation())에도 초기화 뒤(initializeBean())에도 후처리기를 부르지 않는다(AbstractAutowireCapableBeanFactory — Spring Framework 7.0.9 소스). plainPostProcessor를 더하기 전 코드에서 경고가 없던 것은 이 때문으로 본다. 생성 순서를 로그로 직접 보지는 않았고, 흔히 쓰는 스타터가 이런 후처리기를 넣는지도 확인하지 않았다

@Aspect(AspectJ에서 가져온 애노테이션으로, 포인트컷과 어드바이스를 한 클래스에 적는다)로 바꾸면 여섯 요청의 추적 로그 합이 18줄에서 24줄이 되지만 프록시는 빈마다 한 겹이다. @Around(대상 메서드 호출 앞뒤를 감싸는 어드바이스)의 포인트컷이 noLog()를 빼지 않아 noLog() 요청도 2줄씩 찍혀서다. 어드바이저 둘(@Aspect와 advisor3)을 함께 불러와도 마찬가지다. 앱 코드는 그대로 두고 실행 인자로만 등록한 관측용 빈이 시작 직후 v1 컨트롤러 빈을 찍은 줄이다

18:14:29.266 [main] ProxyProbe : probe bean=orderControllerV1 proxy=cglib layers=1 advisors=[ExposeInvocationInterceptor, LogTraceAdvice, AspectJAroundAdvice] target=OrderControllerV1Impl class=hello.advanced.proxy.app.v1.OrderControllerV1Impl$$SpringCGLIB$$0

layers=1은 프록시가 한 겹이라는 뜻이고, advisors= 자리에 찍힌 어드바이스 클래스 이름에 LogTraceAdvice(advisor3의 추적 어드바이스)와 AspectJAroundAdvice(@Around 메서드를 스프링이 바꾼 어드바이스)가 함께 들어 있다. 직접 만든 후처리기 때 JDK 동적 프록시였던 v1이 cglib인 것은 Boot의 spring.aop.proxy-target-class 기본값이 true라서다(Spring Boot Application Properties (4.1)). 같은 AbstractAutoProxyCreator의 wrapIfNecessary()가 빈마다 맞는 어드바이저를 모아 프록시 하나에 넣는다. 맨 앞의 ExposeInvocationInterceptor는 AspectJ 방식 어드바이저가 있으면 스프링이 체인 맨 앞에 넣는 인터셉터다(AspectJProxyUtils — Spring Framework 7.0.9 소스)

경고를 보면 이름이 나온 빈에 프록시가 필요한지부터 본다

이 글의 실행에서 경고는 동작에 영향이 없었다. 직접 만든 후처리기 쪽(설정 클래스, 메인 클래스, LogTrace)은 후처리기가 프록시로 바꾸는 패키지 밖에 있고, 세 빈이 모두 후처리기를 지난 @Lazy 조건에서도 프록시가 된 빈과 요청별 추적 로그 줄 수가 같았다. 자동 프록시 생성기 쪽(AutoProxyConfig, 메인 클래스, LogTrace, advisor3)이 놓친 것은 앞의 등록 순서대로라면 plainPostProcessor를 포함한 순서 지정 없는 후처리기들이고, 프록시를 만드는 생성기는 그 전에 등록돼 있었다. plainPostProcessor를 더하기 전후로 9개 빈의 프록시와 추적 로그 줄 수도 같았다

자기 앱에서 같은 경고를 보면 한 줄을 이렇게 나눠 읽는다

  • Bean '...': 후처리기 등록이 끝나기 전에 만들어져 모든 후처리기를 거치지는 못한 빈이다. 적어도 대괄호 안의 후처리기는 거치지 못했다
  • 대괄호 [...]: 그 빈이 만들어질 때 만들고 있던 후처리기다. 그 후처리기가 이 빈을 직접 받는다고는 할 수 없다. 앞의 plainPostProcessor처럼, 먼저 등록된 자동 프록시 생성기가 어드바이저를 찾느라 만든 빈일 수도 있다
  • declared through a non-static factory method: 그 후처리기의 @Bean 메서드가 static이 아니어서 설정 클래스가 먼저 만들어졌다는 뜻이다. static을 붙이면 이 줄은 사라진다

그다음 이름이 나온 빈이 프록시나 다른 후처리가 필요한 빈인지 본다. @Transactional·@Async처럼 프록시로 붙는 기능이 있거나 직접 만든 애스펙트의 대상이면 확인이 필요하다. 레퍼런스는 후처리기와 그것이 직접 참조하는 빈이 자동 프록시 대상이 아니라고 적는다. 7.0.9의 registerBeanPostProcessors()로 읽으면 경계는 등록 순서다. PriorityOrdered·Ordered 후처리기를 만드는 동안 생긴 빈은 생성기도 놓치고, 순서 지정이 없는 후처리기를 만드는 동안 생긴 빈은 이미 등록된 생성기를 지나는 것으로 읽힌다. 소스로 읽은 것이고 어느 쪽도 프록시 대상 빈으로 실험하지 않았으니, 이름이 나온 빈이 프록시 대상이면 대괄호와 상관없이 직접 확인한다

확인은 컨테이너에서 꺼낸 빈으로 한다. AopUtils.isAopProxy()가 true인지 보고(AopUtils — Spring Framework 7 API), 앞 편에서처럼 Advised로 캐스팅해 getAdvisors()에 필요한 어드바이저가 있는지 본다. 프록시이더라도 필요한 어드바이저가 빠졌을 수 있어서다. 클래스 이름만으로는 가를 수 없다. 위 경고 줄의 BeanPostProcessorConfig$$SpringCGLIB$$0처럼 설정 클래스에도 $$SpringCGLIB$$가 붙지만, 이것은 @Configuration 처리로 바뀐 클래스이고 AOP 프록시는 아니다

고칠 때는 문서가 권하는 대로 후처리기 @Bean 메서드를 static으로 하고 후처리기가 받는 빈을 줄인다. 프록시를 붙이는 일이라면 어드바이저를 빈으로 두고 자동 프록시 생성기에 맡기는 길도 있고, 이 앱에서는 그렇게 바꾸자 경고가 0줄이었다. 후처리가 필요 없는 빈이라 경고만 끄려면 ROLE_INFRASTRUCTURE를 붙일 수 있지만, 앞의 표처럼 그 빈이 후처리기를 지나게 되지는 않는다


출처와 범위

인프런 김영한님의 「스프링 핵심 원리 – 고급편」 강의를 듣고, 강의를 따라 만든 예제를 Spring Boot 4.1.1(Spring Framework 7.0.9, Tomcat 11.0.24)과 Java 25로 옮겨 실행하며 썼다. 실험은 조건마다 코드 몇 줄이나 실행 인자를 바꿔 서버를 새로 띄우고, 시작 로그의 WARN 줄과 후처리기가 받은 빈 이름을 본 뒤 v1·v2·v3의 주문 요청과 noLog() 요청을 한 번씩 보내 추적 로그 줄 수를 셌다. 프록시 종류·층 수·어드바이스 목록은 앱 코드를 바꾸지 않고 실행 인자로만 등록한 관측용 빈이 시작 직후 로그로 남겼고, 후처리기 테스트는 조건마다 Gradle로 한 번씩 돌렸다. 2026년 11월 10일 기준 공식 문서·소스 대조, 비교 실험 스크립트와 관측용 빈 작성, 원고 정리에 AI(Claude)를 썼다

참고 자료