Backend Lab

AOP 동작 원리와 프록시 제약

7 min read

AOP 동작 원리와 프록시 제약

한 줄 정의

AOP(Aspect-Oriented Programming)는 트랜잭션, 로깅, 보안 같은 공통 관심사를 비즈니스 로직에서 분리하는 프로그래밍 기법이다.

실무에서 왜 중요한가

AOP를 이해하지 못하면 다음 문제가 생긴다.

  • @Transactional을 붙였는데 트랜잭션이 동작하지 않는 원인을 모른다.
  • 같은 클래스 내부에서 메서드를 호출했는데 AOP가 적용되지 않는다.
  • private 메서드에 @Transactional을 붙여도 동작하지 않는 이유를 모른다.
  • 프록시 기반 AOP의 제약을 이해하지 못해서 런타임에 예상과 다른 동작이 발생한다.

AOP 핵심 용어

용어의미예시
Aspect공통 관심사를 모듈화한 것트랜잭션 관리, 로깅
Advice실행할 부가 기능@Before, @After, @Around
PointcutAdvice를 적용할 대상 지정execution(* com.example.service.*.*(..))
JoinPointAdvice가 적용될 수 있는 지점메서드 실행 시점
ProxyAOP를 적용하기 위해 생성되는 대리 객체CGLIB 프록시

Spring AOP의 동작 원리

Spring AOP는 프록시 기반으로 동작한다.

클라이언트 → 프록시 객체 → 부가 기능(Advice) 실행 → 실제 객체(Target) 메서드 실행

@Service
public class OrderService {
 
    @Transactional
    public void createOrder(OrderRequest request) {
        // 비즈니스 로직
    }
}

Spring이 OrderService의 프록시 객체를 생성한다. 외부에서 createOrder()를 호출하면 프록시가 트랜잭션을 시작하고, 실제 메서드를 호출한 뒤, 트랜잭션을 커밋하거나 롤백한다.

프록시 생성 방식

방식특징
JDK 동적 프록시인터페이스 기반 프록시. 인터페이스를 구현한 클래스에만 적용 가능
CGLIB 프록시클래스 상속 기반 프록시. 인터페이스 없이도 적용 가능

Spring Boot는 proxyTargetClass=true가 기본값이므로, 인터페이스 유무와 관계없이 CGLIB 프록시를 사용한다.

프록시 기반 AOP의 제약

프록시 기반이기 때문에 내부 호출, private 메서드, final 클래스에서는 AOP가 적용되지 않는다.

대표적인 실패 케이스와 진단 방법은 @Transactional 동작 실패 케이스에서 상세하게 다룬다.

커스텀 AOP 예시

@Aspect
@Component
public class ExecutionTimeAspect {
 
    @Around("execution(* com.example.service.*.*(..))")
    public Object measureTime(ProceedingJoinPoint joinPoint) throws Throwable {
        long start = System.currentTimeMillis();
 
        Object result = joinPoint.proceed(); // 실제 메서드 실행
 
        long elapsed = System.currentTimeMillis() - start;
        log.info("{} executed in {}ms", joinPoint.getSignature(), elapsed);
 
        return result;
    }
}

@Around는 메서드 실행 전후 모두 제어할 수 있는 가장 강력한 Advice다.

Advice 종류

Advice실행 시점용도
@Before메서드 실행 전권한 체크, 파라미터 검증
@After메서드 실행 후 (성공/실패 무관)리소스 정리
@AfterReturning정상 반환 후결과 로깅
@AfterThrowing예외 발생 후에러 로깅, 알림
@Around전후 모두실행 시간 측정, 트랜잭션

자주 나는 실수

  • @Around에서 joinPoint.proceed()를 호출하지 않아서 실제 메서드가 실행되지 않는다.
  • AOP를 남용해서 코드 흐름을 추적하기 어렵게 만든다.
  • 프록시 제약(내부 호출, private, final)을 모르고 AOP가 항상 동작한다고 가정한다.

핵심 요약

Spring AOP는 프록시 기반으로 동작합니다. 외부에서 메서드를 호출하면 프록시가 부가 기능(트랜잭션, 로깅 등)을 실행한 뒤 실제 객체의 메서드를 호출합니다.

프록시 기반이기 때문에 내부 호출, private, final에서는 AOP가 적용되지 않습니다. 구체적인 실패 케이스와 진단 방법은 transactional-pitfalls를 참고합니다.

꼬리 질문

점검 퀴즈

아래 문항은 개념을 실제로 설명할 수 있는지 점검하기 위한 것이다. 선택지를 누르면 정답 여부와 이유가 표시된다.

객관식Spring AOP가 기본적으로 프록시 기반이라는 사실이 만드는 대표 제약은?

OXJDK 동적 프록시는 인터페이스 기반이고, CGLIB은 클래스를 상속해 프록시를 만든다.

객관식AOP를 직접 구현하기 적합한 실무 사례는?

관련 문서

그래프 뷰

백링크