Java 中 Spring 怎么使用 @AfterReturning 和 @AfterThrowing 捕获方法的正常返回与异常退出-java教程-PHP中文网

@afterreturning用于方法成功执行后记录返回结果，@afterthrowing用于方法抛出异常时记录错误；二者均不干预流程，仅作日志监控等副作用操作，需注意切点匹配、参数类型兼容及异常是否被吞没。

java 中 spring 怎么使用 @afterreturning 和 @afterthrowing 捕获方法的正常返回与异常退出

@AfterReturning 和 @AfterThrowing 是 Spring AOP 中两个关键的后置通知类型，分别用于捕获方法**成功执行并正常返回**、以及**抛出异常后退出**的时机。它们不干预方法逻辑，只做日志、监控、清理等副作用操作。

一、@AfterReturning：监听方法正常返回结果

该通知在目标方法**执行完毕、无异常抛出、且有返回值时触发**（void 方法也可监听，但无法获取返回值）。需注意：它不能修改返回值（如需修改，应使用 @Around）。

通过 returning 属性指定形参名，Spring 自动将方法返回值注入该参数
参数类型必须与目标方法返回类型兼容（支持自动装箱/拆箱）
若方法返回 null，且参数为非空引用类型（如 String），该通知仍会执行；若为基本类型（如 int），则抛出 ClassCastException

示例：

@AfterReturning(pointcut = "execution(* com.example.service.UserService.findById(..))", returning = "result")
public void logUserFound(Object result) {
    System.out.println("用户查询成功，返回：" + result);
}

二、@AfterThrowing：捕获方法抛出的异常

该通知在目标方法**执行过程中抛出异常并向上冒泡时触发**，常用于统一错误记录、告警或补偿操作。

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

通过 throwing 属性指定形参名，Spring 将抛出的 Throwable 或其子类实例注入
可限定异常类型：如 throwing = "ex" 且参数声明为 Exception ex，则仅当抛出 Exception 或其子类时触发
若异常被目标方法内部 try-catch 捕获且未 re-throw，则该通知不会执行

示例：

@AfterThrowing(pointcut = "execution(* com.example.service.OrderService.submitOrder(..))", throwing = "ex")
public void logOrderFailure(Exception ex) {
    System.err.println("订单提交失败：" + ex.getMessage());
}

三、注意事项与常见陷阱

这两个通知都属于“后置”类型，本身不改变原有流程，但使用中容易忽略细节：

切点表达式必须准确匹配目标方法签名；若方法被代理对象调用（如 this. 方法），AOP 不生效（因绕过代理）
@AfterReturning 对 void 方法有效，但 returning 参数只能是 Object 或 void 类型（此时无法获取值）
@AfterThrowing 不会拦截 RuntimeException 的子类以外的 Error（如 OutOfMemoryError），也不处理被吞掉的异常
若同时定义 @After、@AfterReturning 和 @AfterThrowing，三者都会执行（@After 总是执行），顺序不可控，不应依赖执行先后

四、配合 @Pointcut 提升可维护性

避免重复写 execution 表达式，推荐抽取公共切点：

@Pointcut("execution(* com.example.service..*.*(..))")
public void serviceMethods() {}
<p>@AfterReturning(pointcut = "serviceMethods()", returning = "result")
public void auditSuccess(Object result) { ... }</p><p>@AfterThrowing(pointcut = "serviceMethods()", throwing = "ex")
public void auditFailure(Throwable ex) { ... }</p>

这样既清晰又便于统一管理切入点逻辑。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南