一文詳解Spring Aop @After(后置通知)的使用場景

更新時間：2025年06月20日 09:09:23 作者：冰糖心書房

@After 是 Spring AOP 中的另一種通知（Advice）類型,通常被稱為“后置通知”或“最終通知”,本文將通過詳細的代碼示例給大家介紹一下Spring Aop @After(后置通知)的使用場景,需要的朋友可以參考下

核心定義

@After 是 Spring AOP 中的另一種通知（Advice）類型，通常被稱為“后置通知”或“最終通知”。

它的核心作用是：

無論目標方法是正常執(zhí)行完成，還是在執(zhí)行過程中拋出了異常，@After 通知中的代碼總是會在目標方法執(zhí)行之后被執(zhí)行。

最經(jīng)典的類比就是 Java 中的 try...catch...finally 語句塊里的 finally 部分。@After 的行為和 finally 塊的行為幾乎一模一樣。

@After 通知的執(zhí)行流程

為了更好地理解，我們來看兩種情況下的執(zhí)行順序：

情況一：目標方法成功執(zhí)行

@Before 通知執(zhí)行。
目標方法 (targetMethod()) 執(zhí)行并正常返回。
@After 通知執(zhí)行。
（如果定義了）@AfterReturning 通知執(zhí)行。

情況二：目標方法拋出異常

@Before 通知執(zhí)行。
目標方法 (targetMethod()) 執(zhí)行，中途拋出異常。
@After 通知執(zhí)行。
（如果定義了）@AfterThrowing 通知執(zhí)行。
異常繼續(xù)向上層調(diào)用棧拋出。

一個非常關(guān)鍵的點是：@After 通知本身無法訪問目標方法的返回值（因為它可能根本沒有返回值，比如拋異常時），也無法捕獲或處理從目標方法中拋出的異常。它只是一個保證“最后一定會被執(zhí)行”的鉤子。

@After 通知能做什么？(主要應用場景)

后置通知非常適合執(zhí)行那些必須進行的“清理”或“收尾”工作，無論業(yè)務邏輯成功與否。

資源釋放 (Resource Cleanup)

這是 @After 最重要、最常見的用途。類似于 finally 塊。
示例：釋放文件句柄、關(guān)閉網(wǎng)絡連接、關(guān)閉數(shù)據(jù)庫連接池中的連接等。確保即使業(yè)務代碼出錯，關(guān)鍵資源也不會被泄露。

上下文清理 (Context Cleanup)

如果在 @Before 通知中向 ThreadLocal 存放了數(shù)據(jù)，那么在 @After 通知中將其 remove() 是一個最佳實踐。這可以防止在線程池環(huán)境中發(fā)生內(nèi)存泄漏或數(shù)據(jù)錯亂。

最終日志記錄 (Final Auditing)

記錄一個操作的結(jié)束。
示例：“方法 updateProduct 執(zhí)行完畢。” 這個日志不關(guān)心成功或失敗，只記錄“結(jié)束”這個事實。

性能監(jiān)控 (Performance Monitoring)

可以在 @Before 中記錄一個開始時間，然后在 @After 中記錄結(jié)束時間，并計算總耗時。

示例：

@Before: long startTime = System.currentTimeMillis(); (存入 ThreadLocal)
@After: long endTime = System.currentTimeMillis(); long duration = endTime - startTime; log.info("方法耗時: {} ms", duration);

與 @AfterReturning 和 @AfterThrowing 的區(qū)別

這是新手很容易混淆的地方，理解它們的區(qū)別至關(guān)重要：

知類型	執(zhí)行時機	能否訪問返回值？	能否訪問異常？	主要用途
@After (最終通知)	總是在目標方法后執(zhí)行（無論成功或失?。?/td>	不能	不能	資源清理、最終日志
@AfterReturning (返回通知)	僅在目標方法成功執(zhí)行后執(zhí)行	可以	不適用	基于返回結(jié)果的附加操作
@AfterThrowing (異常通知)	僅在目標方法拋出異常后執(zhí)行	不適用	可以	異常日志記錄、告警通知

簡單來說：

想總是執(zhí)行清理？用 @After。
想在成功后根據(jù)返回值做點事？用 @AfterReturning。
想在失敗后專門處理異常？用 @AfterThrowing。

代碼示例

我們擴展之前的例子，增加一個刪除方法（可能會失?。?，并為所有方法添加 @After 通知。

1. 業(yè)務服務類 (目標對象)

package com.example.service;

import org.springframework.stereotype.Service;

@Service
public class UserService {

    // 成功執(zhí)行的例子
    public String findUserById(Long id) {
        System.out.println("--- 核心業(yè)務邏輯：正在根據(jù) ID 查詢用戶... ---");
        return "User" + id;
    }

    // 拋出異常的例子
    public void deleteUser(Long id) {
        System.out.println("--- 核心業(yè)務邏輯：正在嘗試刪除用戶... ---");
        if (id <= 0) {
            throw new IllegalArgumentException("用戶ID無效，刪除失敗！");
        }
        System.out.println("用戶 " + id + " 已被成功刪除。");
    }
}

2. 切面類 (Aspect) 中定義 @After 通知

package com.example.aop;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
import org.springframework.stereotype.Component;
import java.util.Arrays;

@Aspect
@Component
public class LoggingAspect {

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

    // 前置通知
    @Before("serviceLayerPointcut()")
    public void logBefore(JoinPoint joinPoint) {
        String methodName = joinPoint.getSignature().getName();
        Object[] args = joinPoint.getArgs();
        System.out.println("==================================================");
        System.out.printf("[AOP 前置通知]: 方法 [%s] 即將執(zhí)行... 參數(shù): %s%n", methodName, Arrays.toString(args));
    }

    // 后置通知 (最終通知)
    @After("serviceLayerPointcut()")
    public void logAfter(JoinPoint joinPoint) {
        String methodName = joinPoint.getSignature().getName();
        System.out.printf("[AOP 后置通知]: 方法 [%s] 執(zhí)行完畢。執(zhí)行清理工作...%n", methodName);
        System.out.println("--------------------------------------------------\n");
    }
}

3. 運行代碼并觀察輸出

調(diào)用成功的方法 userService.findUserById(101L):

==================================================
[AOP 前置通知]: 方法 [findUserById] 即將執(zhí)行... 參數(shù): [101]
--- 核心業(yè)務邏輯：正在根據(jù) ID 查詢用戶... ---
[AOP 后置通知]: 方法 [findUserById] 執(zhí)行完畢。執(zhí)行清理工作...
--------------------------------------------------

@After 在方法成功后執(zhí)行了。

調(diào)用失敗的方法 userService.deleteUser(0L) (需要用 try-catch 捕獲異常):

try {
    userService.deleteUser(0L);
} catch (Exception e) {
    System.err.println("在調(diào)用方捕獲到異常: " + e.getMessage());
}

輸出：

==================================================
[AOP 前置通知]: 方法 [deleteUser] 即將執(zhí)行... 參數(shù): [0]
--- 核心業(yè)務邏輯：正在嘗試刪除用戶... ---
[AOP 后置通知]: 方法 [deleteUser] 執(zhí)行完畢。執(zhí)行清理工作...
--------------------------------------------------

在調(diào)用方捕獲到異常: 用戶ID無效，刪除失??！

即使 deleteUser 拋出了異常，@After 通知 (logAfter 方法) 依然被執(zhí)行了，完美地展示了其 finally 的特性。

總結(jié)

特性	描述
執(zhí)行時機	無論成功或失敗，總是在目標方法執(zhí)行之后執(zhí)行。
核心用途	資源釋放、上下文清理、最終日志記錄等收尾工作。
行為類似	Java 的 `finally` 語句塊。
關(guān)鍵限制	無法訪問目標方法的返回值，也無法捕獲或修改異常。
關(guān)鍵參數(shù)	可以注入 `JoinPoint` 對象，獲取方法元數(shù)據(jù)。