GM 오락실
← 개인 공부 · Backend
STUDY NOTE · 개념 정리

스프링 AOP와 프록시 정리: JDK 동적 프록시 vs CGLIB, self-invocation 문제

Backend
AOP는 로깅, 트랜잭션, 권한 체크처럼 여러 곳에 흩어지는 공통 관심사를 분리해 한 곳에 모으는 방법이다. 스프링 AOP는 대상 빈을 프록시로 감싸 메서드 호출 전후에 부가 기능을 실행한다. 프록시는 인터페이스 기반의 JDK 동적 프록시 또는 클래스 상속 기반의 CGLIB로 만든다. 프록시를 거치지 않는 내부 호출(self-invocation)에는 AOP가 적용되지 않는다.

1. 왜 필요한가

시간 측정과 권한 체크가 서비스 메서드 수백 개에 복사되면, 바꿀 때 모두 고쳐야 하고 핵심 로직이 잘 안 보인다. AOP는 이런 횡단 관심사(cross-cutting concern)를 별도 모듈(Aspect)로 빼고, 어디에 적용할지만 선언하게 한다.

2. 용어

용어의미예
Aspect부가 기능과 적용 위치를 묶은 모듈@Aspect 클래스
Advice실제로 실행할 부가 기능 코드와 실행 시점@Around 메서드
Join PointAdvice를 끼울 수 있는 지점. 스프링 AOP에서는 메서드 실행OrderService.order() 실행
Pointcut어떤 Join Point에 적용할지 고르는 조건execution(* com.example..service..*(..))
Target부가 기능이 적용될 원래 객체OrderService
WeavingAdvice를 대상에 적용하는 과정스프링은 런타임에 프록시 생성으로 수행

3. Advice 종류

애너테이션실행 시점용도
@Before메서드 실행 전파라미터 검증, 권한 체크
@AfterReturning정상 반환 후 (반환값 접근 가능)결과 로깅
@AfterThrowing예외 발생 후 (예외 접근 가능)예외 알림, 에러 로깅
@After정상·예외 관계없이 종료 후 (finally)리소스 정리
@Around전후 모두 감싸고 실행 여부까지 제어실행 시간 측정, 트랜잭션, 캐시, 재시도
@Slf4j
@Aspect
@Component
public class ExecutionTimeAspect {

@Around("@annotation(com.example.common.LogExecutionTime)")
public Object measure(ProceedingJoinPoint joinPoint) throws Throwable {
long start = System.currentTimeMillis();
try {
return joinPoint.proceed(); // 실제 메서드 실행
} finally {
log.info("{} took {}ms", joinPoint.getSignature().toShortString(),
System.currentTimeMillis() - start);
}
}
}

@Around에서 proceed()를 호출하지 않으면 실제 메서드가 실행되지 않는다. 반환값을 돌려주지 않으면 호출자가 null을 받는다. 강력한 만큼 실수하기도 쉬워서, 필요한 시점이 정해져 있으면 더 좁은 Advice를 쓴다.

4. 포인트컷 표현식

지시자예의미
executionexecution(* com.example..*Service.*(..))메서드 시그니처 패턴 (반환 타입, 패키지, 클래스, 메서드, 파라미터)
withinwithin(com.example.order..*)특정 패키지·타입 안의 모든 메서드
@annotation@annotation(com.example.common.LogExecutionTime)해당 애너테이션이 붙은 메서드
beanbean(*Service)빈 이름 패턴 (스프링 AOP 전용)

패키지 패턴은 범위가 넓어 의도치 않은 메서드까지 걸리기 쉽다. 적용 대상을 명확히 하려면 커스텀 애너테이션 방식이 읽기 좋다.

5. 프록시가 동작하는 방식

호출자 ──→ [프록시] ──→ [실제 OrderService]
│
├─ Advice (before)
├─ target.order() 호출
└─ Advice (after)

스프링은 빈을 만든 뒤 BeanPostProcessor 단계에서 포인트컷에 해당하는 빈이면 프록시를 만들어 원래 빈 대신 컨테이너에 등록한다. 그래서 다른 빈이 주입받는 것은 프록시다.

6. JDK 동적 프록시 vs CGLIB

구분JDK 동적 프록시CGLIB
방식인터페이스를 구현한 프록시 객체 생성대상 클래스를 상속한 하위 클래스 생성
조건인터페이스가 있어야 함인터페이스 없어도 됨
주입 타입인터페이스 타입으로만 주입 가능 (구현 클래스 타입으로 주입하면 실패)구현 클래스 타입으로도 주입 가능
제약인터페이스에 선언된 메서드만 가로챔final 클래스는 프록시 불가, final·private 메서드는 가로채지 못함
스프링 기본스프링 프레임워크: 인터페이스가 있으면 사용스프링 부트 2.0 이후: 기본적으로 CGLIB 사용 (proxyTargetClass=true)

스프링 부트가 CGLIB를 기본으로 바꾼 이유 중 하나는, 인터페이스가 있는 빈을 구현 클래스 타입으로 주입받을 때 JDK 프록시면 타입이 맞지 않아 실패하기 때문이다.

7. self-invocation 문제

@Service
public class OrderService {

public void orderAll(List<Order> orders) {
for (Order o : orders) {
this.orderOne(o); // 프록시가 아니라 자기 자신을 직접 호출
}
}

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void orderOne(Order o) { ... } // 트랜잭션이 적용되지 않음
}

외부에서 orderAll을 호출하면 프록시를 거쳐 실제 객체의 orderAll이 실행된다. 그 안의 this.orderOne()은 실제 객체 자신의 메서드를 바로 부르므로 프록시의 Advice가 끼어들 틈이 없다. @Transactional, @Async, @Cacheable 모두 같은 이유로 내부 호출에서는 동작하지 않는다.

해결 방법설명평가
별도 빈으로 분리orderOne을 다른 클래스(OrderOneService)로 옮겨 주입받아 호출가장 권장. 구조도 명확해짐
자기 자신을 주입@Lazy로 자기 프록시를 주입받아 self.orderOne() 호출동작하지만 구조가 어색함
AopContext.currentProxy()exposeProxy 설정 후 현재 프록시를 꺼내 호출AOP 코드가 비즈니스 코드에 섞임
AspectJ 위빙컴파일·로드 시점에 바이트코드에 직접 삽입내부 호출도 적용되지만 설정이 복잡

8. 스프링 AOP vs AspectJ

구분스프링 AOPAspectJ
위빙 시점런타임 (프록시)컴파일 시점, 컴파일 후, 클래스 로드 시점
Join Point스프링 빈의 메서드 실행만메서드 호출·실행, 생성자, 필드 접근 등
대상스프링 빈모든 객체
내부 호출적용 안 됨적용됨

스프링 AOP는 AspectJ의 애너테이션(@Aspect, @Around)과 포인트컷 문법을 빌려 쓰지만, 위빙은 프록시로 한다.

9. 실제로 어떻게 적용되나

  1. @Transactional, @Cacheable, @Async: 스프링이 제공하는 대표적인 AOP다. 내부 호출, private 메서드, final 메서드에서 동작하지 않는 이유가 모두 프록시 구조에서 나온다.
  2. 권한 체크 애너테이션: @RequirePermission("ORDER_CANCEL") 같은 애너테이션을 만들고 @Before Advice에서 현재 사용자의 권한을 확인하면, 서비스 메서드마다 같은 if문을 반복하지 않아도 된다.
  3. 외부 API 호출 로깅: 외부 연동 클라이언트 메서드에 @Around를 걸어 요청 파라미터, 응답 시간, 예외를 일관된 형식으로 남긴다.
  4. AOP가 안 먹을 때 점검 순서: 그 객체가 스프링 빈인가 → 다른 빈에서 호출하는가(내부 호출 아닌가) → 메서드가 public이고 final이 아닌가 → 포인트컷 표현식이 맞는가.

10. 면접 질문으로 정리

  1. Q. AOP란? 여러 모듈에 공통으로 필요한 부가 기능을 핵심 로직에서 분리해 Aspect로 모듈화하고, 포인트컷으로 적용 위치를 지정하는 프로그래밍 방식이다.
  2. Q. 스프링 AOP는 어떻게 동작하나? 빈 생성 후 BeanPostProcessor가 포인트컷 대상 빈을 프록시로 감싸 등록한다. 호출이 프록시를 거칠 때 Advice가 실행되고 실제 객체 메서드가 호출된다.
  3. Q. JDK 동적 프록시와 CGLIB의 차이는? JDK 동적 프록시는 인터페이스를 구현해 프록시를 만들고, CGLIB는 대상 클래스를 상속해 만든다. CGLIB는 인터페이스가 없어도 되지만 final 클래스나 메서드는 프록시할 수 없다.
  4. Q. 같은 클래스 안에서 @Transactional 메서드를 호출하면 왜 적용되지 않나? 내부 호출은 프록시가 아니라 this로 실제 객체의 메서드를 직접 호출해 프록시의 부가 기능을 거치지 않기 때문이다. 메서드를 별도 빈으로 분리해 해결한다.
  5. Q. 스프링 AOP와 AspectJ의 차이는? 스프링 AOP는 런타임 프록시 기반으로 스프링 빈의 메서드 실행에만 적용된다. AspectJ는 바이트코드를 직접 수정해 생성자, 필드 접근, 내부 호출까지 적용할 수 있다.
Gunmo Lee
since 2021.07
스프링 AOP와 프록시 정리: JDK 동적 프록시 vs CGLIB, self-invocation 문제 | GM 오락실