@Transactional을 붙인 메서드를 같은 클래스의 다른 메서드에서 부르면 트랜잭션이 시작되지 않는다. 스프링 AOP는 빈 자리에 프록시(실제 객체 대신 호출을 받는 객체)를 등록하고, 프록시가 호출 앞뒤에서 부가 기능 코드인 어드바이스를 실행한다. 그런데 객체 안에서 this로 부른 호출은 그 프록시를 지나지 않는다(Using @Transactional — Spring Framework 7.0 레퍼런스). 이 스프링 AOP 내부 호출 문제는 포인트컷(어드바이스를 걸 메서드를 고르는 조건)이 그 메서드를 고르고 있어도 생긴다
고치는 방법은 호출이 프록시를 다시 지나게 하는 것이다. 자기 자신을 주입받거나(자기 주입), 부를 때 컨테이너에서 빈을 찾아오거나(지연 조회), 메서드를 다른 빈으로 떼어 내면(구조 변경) 된다. 셋 가운데 구조 변경을 먼저 고르고 자기 주입은 마지막에 둔다. 스프링이 애노테이션으로 거는 @Retryable도 같은 객체 안에서 부르면 재시도하지 않았다
this로 부른 메서드는 프록시를 거치지 않아 어드바이스가 걸리지 않는다
강의 코드의 CallServiceV0은 내부 호출을 그대로 둔 서비스로, external() 안에서 같은 클래스의 internal()을 부른다. 애스펙트(포인트컷과 어드바이스를 한 클래스에 담은 것) CallLogAspect는 이 패키지(internalcall)의 모든 메서드 앞에서 aop=와 메서드 시그니처를 로그로 남긴다. 테스트 CallServiceV0Test는 @SpringBootTest로 스프링 컨테이너를 띄우고 @Import로 이 애스펙트를 빈으로 등록한다. 서비스와 애스펙트 코드다
@Slf4j
@Component
public class CallServiceV0 {
public void external() {
log.info("call external");
internal(); //내부 메서드 호출(this.internal())
}
public void internal() {
log.info("call internal");
}
}
@Slf4j
@Aspect
public class CallLogAspect {
@Before("execution(* hello.advanced.aop.internalcall..*.*(..))")
public void doLog(JoinPoint joinPoint) {
log.info("aop={}", joinPoint.getSignature());
}
}
테스트에서 external()과 internal()을 따로 부른 로그다. 앞의 세 줄이 external(), 뒤의 두 줄이 internal()을 부른 결과다
14:00:10.048 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV0.external() 14:00:10.049 INFO [Test worker] CallServiceV0 : call external 14:00:10.049 INFO [Test worker] CallServiceV0 : call internal 14:00:12.118 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV0.internal() 14:00:12.118 INFO [Test worker] CallServiceV0 : call internal
external()을 부르면 aop= 줄이 external() 앞에만 있고, 그 안에서 부른 internal() 앞에는 없다. 같은 internal()도 테스트가 밖에서 부르면 aop= 줄이 찍힌다. 테스트가 받은 빈은 프록시라서 external() 호출은 프록시를 거쳐 어드바이스가 실행되지만, 프록시가 실제 객체의 external()을 부른 다음부터는 실행이 실제 객체 안에 있다. 그 안의 internal()은 this.internal()이고 this는 실제 객체라 프록시를 다시 지나지 않는다. 레퍼런스도 this를 거치는 자기 호출은 어드바이스를 건너뛴다고 적는다(Understanding AOP Proxies — Spring Framework 7.0 레퍼런스)
두 실행에서 포인트컷은 같았고 internal()도 고르고 있었다. 어드바이스가 걸리느냐를 가른 것은 호출이 들어온 경로다. 내부 호출에 어드바이스가 걸리지 않는 것은 설정이나 포인트컷의 잘못이 아니라 프록시 방식의 구조에서 나온다. 프록시는 객체 바깥에서 호출을 받아 실제 객체에 넘기는 객체라서, 실제 객체 안에서 this로 부른 호출에는 끼어들 자리가 없다. 그래서 어드바이스가 빠진 메서드를 보면 포인트컷 식을 고치기 전에, 그 호출이 같은 객체 안에서 this로 들어왔는지부터 확인한다
스프링의 @Retryable도 this로 부르면 재시도하지 않는다
메서드에 애노테이션 하나를 붙여 부가 기능을 거는 방식도 같은 프록시 위에서 돈다. 강의에서는 직접 정의한 @Retry 애노테이션을 붙인 메서드가 예외를 던지면 다시 부르는 애스펙트 RetryAspect를 만들었다. 포인트컷 @annotation(retry)가 @Retry가 붙은 메서드를 고르면서 그 애노테이션을 어드바이스의 retry 파라미터로 넘기고, @Around 어드바이스가 proceed()(다음 어드바이스나 대상 메서드로 호출을 넘기는 메서드)를 반복문 안에서 다시 부른다
@Around("@annotation(retry)")
public Object doRetry(ProceedingJoinPoint joinPoint, Retry retry) throws Throwable {
log.info("[retry] {} retry={}", joinPoint.getSignature(), retry);
int maxRetry = retry.value();
Exception exceptionHolder = null;
for (int retryCount = 1; retryCount <= maxRetry; retryCount++) {
try {
log.info("[retry] try count={}/{}", retryCount, maxRetry);
return joinPoint.proceed();
} catch (Exception e) {
exceptionHolder = e;
}
}
throw exceptionHolder;
}
ExamRepository는 save()가 다섯 번에 한 번 예외를 던지는 저장소이고, 테스트 ExamTest는 ExamService를 거쳐 save()를 다섯 번 부른다. save()에 @Retry(value = 4)를 붙이고 이 애스펙트를 등록하자 다섯 번째 요청이 두 번째 시도(try count=2/4)에서 성공해 테스트가 통과했다. 재시도는 프록시가 실행하는 어드바이스 안의 반복문이라, 앞의 internal()처럼 프록시를 지나지 않은 호출은 이 반복문에 들어오지 않는다
스프링 프레임워크에도 같은 일을 하는 @Retryable이 7.0부터 들어 있다(Resilience Features — Spring Framework 7.0 레퍼런스). @EnableResilientMethods로 처리를 켜면 스프링이 이 애노테이션이 붙은 빈을 프록시로 만들어 재시도 어드바이스를 건다. Boot 4.1도 이 설정을 자동으로 켜 주지 않으니 직접 붙여야 한다(spring-boot#46916). 레퍼런스는 타입에 붙인 @Retryable이 프록시를 거쳐 불리는 메서드에 적용된다고 적는다. 내부 호출에서 어떻게 되는지 보려고, 첫 호출만 실패하는 flaky()와 그것을 this로 부르는 external()을 가진 확인용 빈을 Boot 없이 @EnableResilientMethods만 켠 스프링 컨텍스트에 올렸다
public static class FlakyService {
private int calls;
// 호출 횟수를 읽고 되돌리는 calls()·reset()은 생략
public String external() {
return flaky(); // 내부 호출(this.flaky())
}
@Retryable(maxRetries = 2, delay = 0)
public String flaky() {
calls++;
if (calls < 2) {
throw new IllegalStateException("첫 호출 실패");
}
return "ok";
}
}
컨텍스트에서 꺼낸 빈으로 flaky()와 external()을 한 번씩 부르고, 결과와 flaky() 호출 횟수를 남겼다. 첫 줄은 빈이 AOP 프록시인지와 그 클래스 이름이다
14:00:08.070 INFO [Test worker] Post09RetryProbeTest : PROBE key=retryProxy result=true | hello.advanced.post09probe.Post09RetryProbeTest$FlakyService$$SpringCGLIB$$0 14:00:08.077 INFO [Test worker] Post09RetryProbeTest : PROBE key=retryDirect result=ok/calls2 14:00:08.077 INFO [Test worker] Post09RetryProbeTest : PROBE key=retryInternal result=IllegalStateException/calls1
빈은 CGLIB 프록시(클래스를 상속해 만든 프록시)였다. 프록시로 flaky()를 부르면 두 번째 호출에서 ok를 돌려줬고, external()을 부르면 flaky()가 한 번만 불리고 첫 예외가 그대로 나왔다. 앞의 CallLogAspect도 @Retryable도 프록시를 거친 호출에만 걸렸으니, 같은 클래스 안에서 부르는 메서드에 재시도를 걸려면 그 호출부터 프록시를 지나게 해야 한다
내부 호출을 푸는 세 대안은 프록시를 언제 어디서 얻느냐가 다르다
프록시 대신 AspectJ로 컴파일할 때나 클래스를 로딩할 때 바이트코드에 어드바이스를 직접 넣으면 이 문제가 없다고 레퍼런스는 적는다(앞의 Understanding AOP Proxies). 강의는 이 방식이 설정이 복잡하고 JVM 옵션을 줘야 해서 실무에서는 거의 쓰지 않는다고 설명하고, 프록시 방식 안에서 내부 호출을 푸는 대안 셋을 다룬다. 자기 자신을 주입받는 자기 주입, 필요할 때 빈을 찾아오는 지연 조회, 구조를 바꾸는 구조 변경이고, 서비스 이름도 차례로 CallServiceV1~CallServiceV3이다
대안 셋은 모두 호출이 프록시를 다시 지나게 만드는 방법이고, 다른 점은 그 프록시를 언제 어디서 얻느냐다. 자기 주입은 빈을 만들 때 자기 프록시를 받아 두고, 지연 조회는 부르는 순간 컨테이너에서 찾아오며, 구조 변경은 메서드를 다른 빈으로 옮겨 그 빈의 프록시를 부른다
자기 주입
CallServiceV1은 자기 자신을 세터로 주입받고, internal()을 주입받은 참조로 부른다. 컨테이너가 넣어 주는 것은 프록시이므로 이 호출은 프록시를 거친다. 생성자로 받으면 자기 자신을 만드는 도중에 자기 자신이 필요해지므로, 객체를 만든 뒤에 따로 주입되는 세터로 받는다
@Slf4j
@Component
public class CallServiceV1 {
private CallServiceV1 callServiceV1;
@Autowired
public void setCallServiceV1(CallServiceV1 callServiceV1) {
log.info("callServiceV1 setter={}", callServiceV1.getClass());
this.callServiceV1 = callServiceV1;
}
public void external() {
log.info("call external");
callServiceV1.internal();
}
public void internal() {
log.info("call internal");
}
}
다만 Boot 2.6부터 빈 사이의 순환 참조가 기본으로 금지됐다(Spring Boot 2.6 Release Notes — Circular References Prohibited by Default). 그래서 이 코드를 Spring Boot 4.1.1에서 그대로 돌리면 테스트 CallServiceV1Test가 BeanCurrentlyInCreationException으로 스프링 컨테이너를 띄우지 못한다. Boot가 시작에 실패한 원인과 고칠 방향을 풀어 남기는 실패 분석의 마지막 줄과, 실패 스택에서 가장 안쪽 원인 줄이다
Relying upon circular references is discouraged and they are prohibited by default. Update your application to remove the dependency cycle between beans. As a last resort, it may be possible to break the cycle automatically by setting spring.main.allow-circular-references to true. Caused by: org.springframework.beans.factory.BeanCurrentlyInCreationException: Error creating bean with name 'callServiceV1': Requested bean is currently in creation: Is there an unresolvable circular reference or an asynchronous initialization dependency?
실패 분석은 고리를 없애라고 한 뒤, 마지막 수단으로 spring.main.allow-circular-references를 true로 두면 고리를 자동으로 끊을 수도 있다고 알려 준다. 이 설정(4.1 기본값 false, Spring Boot Application Properties (4.1))을 켜면 동작하지만, 컨텍스트 전체의 순환 참조를 허용하는 설정이다. @SpringBootTest는 앱의 메인 설정 클래스로 컨텍스트를 띄워 같은 컴포넌트 스캔 범위의 빈을 함께 만들므로, 설정 없이 CallServiceV1이 그 범위에 있기만 해도 자기 주입과 상관없는 CallServiceV0Test까지 같은 예외로 시작하지 못했다
설정을 켜고 CallServiceV1Test가 external()을 부른 로그다
14:00:14.198 INFO [Test worker] CallServiceV1 : callServiceV1 setter=class hello.advanced.aop.internalcall.CallServiceV1$$SpringCGLIB$$0 14:00:14.720 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV1.external() 14:00:14.720 INFO [Test worker] CallServiceV1 : call external 14:00:14.720 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV1.internal() 14:00:14.721 INFO [Test worker] CallServiceV1 : call internal
세터로 들어온 객체의 클래스 이름에 $$SpringCGLIB$$가 붙어 CGLIB 프록시이고, internal() 앞에도 aop= 줄이 있다. 세터가 불리는 때는 callServiceV1 빈이 아직 만들어지는 중인데도 프록시가 들어왔다. 순환 참조를 허용하면 스프링은 만드는 중인 빈의 이른 참조를 내주고(AbstractAutowireCapableBeanFactory.java — Spring Framework v7.0.9 소스), 빈을 프록시로 바꾸는 자동 프록시 생성기가 그 이른 참조를 프록시로 감싸 돌려주기 때문이다(AbstractAutoProxyCreator.java — Spring Framework v7.0.9 소스). 자동 프록시 생성기가 빈 후처리기로서 빈을 바꿔 끼우는 과정은 빈 후처리기를 다룬 글에서 다뤘다. 생성자로 받으면 설정을 켜도 같은 예외로 멈췄는데, 객체를 만들기 전에 인자가 있어야 하니 내줄 이른 참조가 아직 없어서다
지연 조회
CallServiceV2는 자기 자신 대신 빈을 찾아 줄 ObjectProvider를 생성자로 받아 두고, 호출할 때 getObject()로 컨테이너에서 빈을 꺼낸다. ApplicationContext.getBean()으로도 찾을 수 있지만, 컨텍스트는 빈 하나를 찾기에 너무 큰 객체라 강의는 ObjectProvider를 권한다. CallServiceV2의 해당 부분이다
private final ObjectProvider<CallServiceV2> callServiceProvider;
public CallServiceV2(ObjectProvider<CallServiceV2> callServiceProvider) {
this.callServiceProvider = callServiceProvider;
}
public void external() {
log.info("call external");
CallServiceV2 callServiceV2 = callServiceProvider.getObject();
callServiceV2.internal(); //외부 메서드 호출
}
순환 참조 설정이 꺼져 있고 CallServiceV1의 자기 주입 코드와 그 테스트는 주석 처리된 상태에서 CallServiceV2Test가 external()을 부른 로그다
14:00:25.816 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV2.external() 14:00:25.816 INFO [Test worker] CallServiceV2 : call external 14:00:25.816 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV2.internal() 14:00:25.816 INFO [Test worker] CallServiceV2 : call internal
생성자로 받는 것은 ObjectProvider라서 만드는 동안 자기 자신이 필요 없고, getObject()는 이미 프록시로 바뀌어 등록된 빈을 돌려준다. 그래서 설정 없이도 internal() 앞에 aop= 줄이 찍혔다. ApplicationContext.getBean() 판으로 바꿔 돌려도 결과가 같았다
구조 변경
CallServiceV3은 internal()을 별도 빈 InternalService로 떼어 내고, 그 빈을 생성자로 받아 부른다
@Slf4j
@Component
@RequiredArgsConstructor
public class CallServiceV3 {
private final InternalService internalService;
public void external() {
log.info("call external");
internalService.internal(); //외부 메서드 호출
}
}
@Slf4j
@Component
public class InternalService {
public void internal() {
log.info("call internal");
}
}
같은 상태에서 CallServiceV3Test가 external()을 부른 로그다
14:00:30.766 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.CallServiceV3.external() 14:00:30.766 INFO [Test worker] CallServiceV3 : call external 14:00:30.766 INFO [Test worker] CallLogAspect : aop=void hello.advanced.aop.internalcall.InternalService.internal() 14:00:30.766 INFO [Test worker] InternalService : call internal
internal()이 다른 빈의 메서드가 되어 그 빈의 프록시를 거치므로 InternalService.internal() 앞에도 aop= 줄이 있다. 같은 객체 안의 this 호출이 처음부터 없으니, 순환 참조 설정도 컨테이너 조회도 필요 없고 평범한 생성자 주입만 남는다
구조 변경을 먼저 고르고 자기 주입은 마지막에 둔다
강의에서 배운 결론은 내부 호출이 생기지 않게 구조를 바꾸는 것이 가장 낫다는 것이었다. 자기 주입과 지연 조회는 세터나 프로바이더를 끼워 넣어야 해서 억지로 하는 느낌이 있다는 이유였다. 레퍼런스는 자기 호출 문제를 풀 방법으로 코드를 고쳐 자기 호출을 없애는 것을 먼저 들고, 가장 좋고 가장 덜 침습적인 방법이라 한다. 다음이 자기 참조 주입이고, 마지막인 AopContext.currentProxy()(실행 중인 프록시를 꺼내 쓰는 방법)는 되도록 쓰지 말라고 강하게 말린다(앞의 Understanding AOP Proxies). @Autowired 절은 자기 참조를 마지막 수단으로만 쓰고, 그런 경우 해당 메서드를 별도 빈으로 떼어 내는 것을 고려하라고 한다(Self Injection — Spring Framework 7.0 레퍼런스)
내부 호출을 만나면 먼저 그 메서드를 다른 빈으로 떼어 낼 수 있는지 보고, 어렵다면 ObjectProvider로 부를 때 찾아오며, 자기 주입은 마지막에 둔다. Boot 4.1에서는 세터 자기 주입 하나 때문에 컨텍스트 전체의 순환 참조 설정을 켜야 해서, 이 순서를 지킬 이유가 하나 더 있다
이 시리즈의 글: 스프링 프록시와 AOP
- ThreadLocal remove는 가상 스레드를 켜도 남겨 둔다
- 템플릿 콜백 패턴으로 감싸면 추적기를 ScopedValue로 옮길 수 있다
- @RequestMapping만 붙인 타입은 Spring 6부터 컨트롤러가 아니다
- JDK 동적 프록시의 InvocationHandler는 대상 예외를 풀어서 던져야 한다
- ProxyFactory 프록시는 어드바이저가 없으면 대상을 그대로 부른다
- 빈 후처리기가 받는 빈은 그 후처리기를 거치지 못한다
- 스프링 AOP 어드바이스 규칙은 종류마다 할 수 있는 일을 좁힌다
- 스프링 AOP 포인트컷 지시자가 클래스만 보고 답하지 못하면 그 빈은 일단 프록시가 된다
- 스프링 AOP 내부 호출은 프록시를 다시 지나게 해야 어드바이스가 걸린다 (이 글)
출처와 범위
인프런 김영한님의 「스프링 핵심 원리 – 고급편」 강의를 듣고, 강의를 따라 만든 예제를 Spring Boot 4.1.1(Spring Framework 7.0.9, Tomcat 11.0.24)과 Java 25로 옮겨 실행하며 썼다. 실험은 서버를 띄우지 않고, 조건에 따라 강의 코드나 테스트를 몇 줄 바꾸거나 그대로 두고 Gradle로 테스트 클래스나 메서드 하나를 한 번씩 돌렸다. 설정을 켠 세터 자기 주입 조건에는 세터로 받은 객체와 테스트가 받은 빈의 프록시 설정을 찍는 관측 로그 두 줄을 더했고, 로그 블록에서는 그 두 줄을 뺐다. @Retryable 내부 호출 확인은 컴포넌트 스캔 범위 밖에 둔 확인용 테스트로 했다. 2026년 11월 15일 기준 Boot 4.1에서 막힌 지점의 원인 확인과 공식 문서·스프링 소스·이슈 대조, 비교 실험 스크립트와 확인용 코드 작성, 원고 정리에 AI(Claude)를 썼다
참고 자료
- Using @Transactional — Spring Framework 7.0 레퍼런스
- Understanding AOP Proxies — Spring Framework 7.0 레퍼런스
- Resilience Features — Spring Framework 7.0 레퍼런스
- spring-boot#46916: Auto-configure @EnableResilientMethods
- Spring Boot 2.6 Release Notes — Circular References Prohibited by Default
- Spring Boot Application Properties (4.1)
- AbstractAutowireCapableBeanFactory.java — Spring Framework v7.0.9 소스
- AbstractAutoProxyCreator.java — Spring Framework v7.0.9 소스
- Self Injection — Spring Framework 7.0 레퍼런스