编辑“︁Spring异常通知”︁（章节）

= Spring异常通知 =

'''Spring异常通知'''（After Throwing Advice）是Spring AOP（面向切面编程）中五种通知类型之一，用于在目标方法抛出异常时执行特定逻辑。它允许开发者在不修改原有业务代码的情况下，集中处理异常情况，例如日志记录、事务回滚或自定义错误响应。

== 核心概念 ==

异常通知通过`@AfterThrowing`注解或XML配置实现，具有以下特点：
* 仅在目标方法抛出异常时触发
* 可以捕获特定异常类型（默认捕获`Throwable`）
* 能访问异常对象和原始方法参数
* 不影响异常传播（除非在通知中处理异常）

<mermaid>
graph LR
    A[客户端调用] --> B[目标方法]
    B --> C{抛出异常?}
    C -->|是| D[执行异常通知]
    C -->|否| E[正常返回]
    D --> F[异常传播]
</mermaid>

== 实现方式 ==

=== 基于注解的实现 ===

<syntaxhighlight lang="java">
@Aspect
@Component
public class ExceptionLoggingAspect {

    // 捕获所有异常
    @AfterThrowing(pointcut = "execution(* com.example.service.*.*(..))", throwing = "ex")
    public void logAfterThrowing(JoinPoint joinPoint, Throwable ex) {
        String methodName = joinPoint.getSignature().getName();
        System.err.println("方法 '" + methodName + "' 抛出异常: " + ex.getMessage());
    }

    // 捕获特定异常
    @AfterThrowing(
        pointcut = "execution(* com.example.service.*.*(..))",
        throwing = "ex",
        value = "execution(* com.example.service.*.*(..))"
    )
    public void handleDatabaseException(DataAccessException ex) {
        System.err.println("数据库操作异常: " + ex.getCause());
    }
}
</syntaxhighlight>

=== 基于XML的配置 ===

<syntaxhighlight lang="xml">
<aop:config>
    <aop:aspect id="exceptionAspect" ref="exceptionHandler">
        <aop:after-throwing 
            method="logException"
            pointcut="execution(* com.example.service.*.*(..))"
            throwing="ex"/>
    </aop:aspect>
</aop:config>

<bean id="exceptionHandler" class="com.example.aop.ExceptionHandler"/>
</syntaxhighlight>

== 参数解析 ==

异常通知方法可以接收以下参数：
* '''JoinPoint'''：提供方法上下文信息
* '''Throwable'''（或具体异常类型）：通过`throwing`属性指定的异常对象
* 方法参数（需要与切入点表达式匹配）

数学表示通知执行时机：
<math>
T_{advice} = \begin{cases} 
execute, & \text{当 } T_{method} \text{ 抛出异常} \\
\emptyset, & \text{否则}
\end{cases}
</math>

== 实际应用案例 ==

=== 案例1：统一异常日志 ===

<syntaxhighlight lang="java">
@AfterThrowing(
    pointcut = "within(@org.springframework.stereotype.Service *)",
    throwing = "ex"
)
public void logServiceException(JoinPoint jp, RuntimeException ex) {
    LogEntry entry = new LogEntry(
        LocalDateTime.now(),
        jp.getSignature().toShortString(),
        ex.getClass().getSimpleName(),
        ex.getMessage()
    );
    auditLogRepository.save(entry);
}
</syntaxhighlight>

=== 案例2：事务补偿 ===

<syntaxhighlight lang="java">
@AfterThrowing(
    pointcut = "@annotation(org.springframework.transaction.annotation.Transactional)",
    throwing = "ex"
)
public void compensateOnFailure(DataAccessException ex) {
    compensationService.scheduleRetry(
        ex.getFailedOperationId(), 
        Instant.now().plusSeconds(30)
    );
}
</syntaxhighlight>

== 最佳实践 ==

1. '''异常过滤'''：明确指定要处理的异常类型，避免捕获过于宽泛的`Throwable`
2. '''轻量级操作'''：异常通知不应包含复杂逻辑或可能失败的操作
3. '''关注点分离'''：将异常处理逻辑与业务逻辑解耦
4. '''性能考量'''：高频异常场景应考虑异步处理

== 常见问题 ==

'''Q: 异常通知能否阻止异常传播？'''
A: 不能直接阻止，但可以通过在通知中捕获并处理异常来实现类似效果。

'''Q: 如何获取抛出异常的方法参数？'''
A: 通过JoinPoint对象：
<syntaxhighlight lang="java">
Object[] args = joinPoint.getArgs();
</syntaxhighlight>

'''Q: 多个异常通知的执行顺序？'''
A: 使用`@Order`注解或实现`Ordered`接口控制顺序。

== 进阶主题 ==

* 组合使用`@After`和`@AfterThrowing`实现完成通知
* 通过AOP代理处理自调用方法的异常
* 使用Spring Retry与异常通知构建弹性系统

通过合理使用异常通知，可以显著提高系统的可维护性和错误处理一致性，同时保持业务代码的整洁性。

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring AOP]]