Spring AOP 核心概念速成：切面、切點、連接點、通知類型與執行順序控制

AOP 核心術語對照表

六種通知類型與適用場景

連接點 API 實戰：獲取方法簽名、參數、目標對象

@Aspect @Component
public class LoggingAspect {
    private static final Logger log = LoggerFactory.getLogger(LoggingAspect.class);

    @Pointcut("execution(* com.example.service..*(..))")
    public void serviceLayer() {}

    @Before("serviceLayer()")
    public void logBefore(JoinPoint jp) {
        Signature sig = jp.getSignature();  // 方法簽名
        String methodName = sig.getName();
        String className = sig.getDeclaringTypeName();
        Object[] args = jp.getArgs();       // 實際參數
        Object target = jp.getTarget();     // 目標對象實例
        log.info("▶ {}.{} args={}", className, methodName, Arrays.toString(args));
    }

    @AfterReturning(pointcut = "serviceLayer()", returning = "result")
    public void logAfter(JoinPoint jp, Object result) {
        log.info("■ {}.{} result={}", jp.getSignature().getDeclaringTypeName(), jp.getSignature().getName(), result);
    }

    @Around("serviceLayer()")
    public Object profile(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.nanoTime();
        try {
            return pjp.proceed();  // **必須調用**，否則目標方法不執行
        } finally {
            long cost = (System.nanoTime() - start) / 1_000_000;
            log.info("⏱ {}.{} took {} ms", pjp.getSignature().getDeclaringTypeName(), pjp.getSignature().getName(), cost);
        }
    }
}

切點表達式語法速查

execution(modifiers? return_type package.Class.method(args))

// 常用模式
execution(* com.example.service.*.*(..))           // service 包所有類所有方法
execution(* com.example.service.UserService.*(..)) // 指定類所有方法
execution(* com.example.service.*.save*(..))       // 以 save 開頭的方法
execution(* *(..))                                 // 所有方法（慎用）
execution(!private * *(..))                        // 非私有方法
execution(public * *(@Transactional ..))           // 參數帶註解的方法

切點表達式復用與組合

@Aspect @Component
public class CommonPointcuts {
    @Pointcut("execution(* com.example.service..*(..))")
    public void inServiceLayer() {}

    @Pointcut("@annotation(org.springframework.transaction.annotation.Transactional)")
    public void transactional() {}

    @Pointcut("inServiceLayer() && transactional()")
    public void transactionalInService() {}
}

// 其他切面引用
@Aspect @Component
public class TxAspect {
    @Around("com.example.aop.CommonPointcuts.transactionalInService()")
    public Object manageTx(ProceedingJoinPoint pjp) throws Throwable { ... }
}

多切面執行順序控制：@Order

• 數值**越小優先級越高**（先織入）。
• 環繞通知：@Order(1) 的 @Around **最外層**包裹 @Order(2) 的 @Around。
• 前置通知：@Order(1) 的 @Before **先於** @Order(2) 執行。
• 後置/返回/異常通知：@Order(1) **後於** @Order(2) 執行（棧式展開）。

@Aspect @Component @Order(1)  // 最外層事務
public class TransactionAspect { ... }

@Aspect @Component @Order(2)  // 內層日誌
public class LoggingAspect { ... }

JoinPoint vs ProceedingJoinPoint 選擇指南

• JoinPoint：用於 @Before、@After、@AfterReturning、@AfterThrowing，**只讀**連接點信息。
• ProceedingJoinPoint：僅用於 @Around，**必須調用 proceed()** 繼續執行目標方法，可決定是否執行、執行幾次、捕獲異常、修改參數/返回值。

常見坑點