异常处理与 AOP 切面：利用 Spring Aspect 拦截方法执行异常并实现统一的日志增强变量注入

Spring AOP 提供了一种优雅的方式，让你在不侵入业务代码的前提下，把异常处理和日志记录都统一管起来。这里最关键的一环，就是用 @AfterThrowing 来捕获异常，再配合环绕通知或精准的切点表达式定位到具体方法，最后通过参数注入（比如 JoinPoint 和异常对象）实现上下文感知的日志增强。

整个过程可以拆解为几个核心要点，理解了这些，你就能在实际项目中用得游刃有余。

明确异常通知的触发条件

@AfterThrowing 是专为异常场景设计的通知类型，它的特性很清晰：只在目标方法抛出指定异常时执行，不会干扰正常流程。这一点和 @After（总会执行）或 @Around（需要手动控制流程）有本质区别。

那么，要让它跑起来，需要注意几个关键点：

• 必须显式声明 throwing 属性，绑定异常形参，否则你拿不到异常实例。
• 切点表达式要聚焦具体层级，比如用 @within(org.springframework.stereotype.Service) 指向 Service 层，或者用更细粒度的 execution(* com.example.service..*.*(..)) 来限定包路径。
• 如果需要捕获自定义异常，确保这个异常类在切点范围内被抛出，并且没有被上层的 try-catch 给吞掉。

注入异常与执行上下文变量

Spring AOP 允许你在通知方法里直接接收运行时信息，省去手动反射的麻烦。这其实是它的一个天然优势：

• JoinPoint joinPoint 能提供方法签名、参数值、目标对象等基础信息。
• Throwable exception 由 throwing="exception" 绑定，你可以直接调用 getMessage() 或 getStackTrace() 获取异常细节。
• 在 Web 环境下，还可以结合 RequestContextHolder 获取当前 HTTP 请求信息，让日志包含更多上下文。

构建可读性强的日志内容

光是打印堆栈还远远不够，结构化的关键诊断字段才是让问题定位变得简单的关键。常见做法包括：

• 记录完整的方法签名：joinPoint.getSignature().toShortString()
• 打印入参快照，但务必注意脱敏敏感字段，比如密码、身份证号。
• 包含异常类型、异常消息、时间戳、以及请求的唯一 ID（比如 traceId），方便链路追踪。
• 一个理想的日志格式长这样：[ERROR] ServiceException in UserService.updateUser(id=123): Validation failed - email format invalid

与环绕通知协同做异常兜底

光靠 @AfterThrowing 其实没法修改返回值，也没法阻止异常传播。如果要做统一的异常转换——比如给 REST API 返回标准错误码——那就得靠 @Around 来兜底。

具体操作也不复杂：在 proceed() 调用后 catch 异常，先记录日志，再做异常转换，最后要么重新抛出，要么返回一个友好的结果。两者可以共存：@Around 负责控制流程，@AfterThrowing 负责审计留痕，各司其职。