Spring AOP能否抛出受检异常？抛自定义异常触发UndeclaredThrowableException

首先明确结论：Spring AOP中完全可以抛出受检异常，你遇到的UndeclaredThrowableException是JDK动态代理的机制限制导致的，和自定义异常本身的类型没有直接关系。

先修正基础代码错误 #

你贴出的切面代码存在两处语法错误，先修复再排查其他问题：

1. 方法参数列表未闭合：ProceedingJoinPoint pjp 后缺少右括号
2. 异常构造的字符串参数引号未闭合："My custom error 缺少结尾双引号

修正后可正常编译的基础代码如下：

@Around("@annotation(MyCustomAnnotation)")
public Object validateAspect(ProceedingJoinPoint pjp) throws Throwable {
    // 测试直接抛出异常
    throw new AuthorizationException("My custom error");
}

问题根因 #

UndeclaredThrowableException是JDK动态代理的专属异常，触发逻辑非常明确：
当Spring AOP默认使用JDK动态代理为目标类生成代理对象时（基于接口实现代理，而非基于子类生成代理），代理方法执行过程中抛出的异常必须满足以下任意一个条件才会被原封不动抛出，否则就会被JDK代理包装为UndeclaredThrowableException：

• 异常属于RuntimeException或Error的子类（这类异常不需要在方法签名上显式声明）
• 异常属于受检异常，且已经在被拦截的目标业务方法的throws子句中显式声明

你自定义的AuthorizationException本身是RuntimeException子类，按逻辑不会被包装，出现包装问题大概率是代理模式配置、或者异常被上层切面二次包装导致的。

可落地的解决方案 #

按优先级依次尝试即可：

• 强制使用CGLIB代理
  直接从根源规避JDK动态代理的异常包装限制。
  Spring Boot项目在application.yml中添加配置：

  spring:
    aop:
      proxy-target-class: true
  

  非Spring Boot项目在AOP开启注解上配置属性：

  @EnableAspectJAutoProxy(proxyTargetClass = true)
  

• 在目标方法上显式声明异常
  如果因特殊原因不能切换CGLIB代理，就在被@MyCustomAnnotation标注的目标业务方法上加上throws AuthorizationException声明，JDK代理校验异常类型时会直接放行，不会做包装处理。
• 全局异常处理器增加拆包装逻辑
  如果前两步配置后仍能拿到包装异常，在全局异常处理逻辑中先拆出真实异常再处理，同时解决自定义消息为null的问题：

  @RestControllerAdvice
  public class GlobalExceptionHandler {
      @ExceptionHandler(Exception.class)
      public ResponseEntity<?> handleAllExceptions(Exception e) {
          Throwable realException = e;
          // 拆解JDK动态代理包装的异常
          if (e instanceof UndeclaredThrowableException) {
              realException = ((UndeclaredThrowableException) e).getUndeclaredThrowable();
          }
          // 处理自定义权限异常
          if (realException instanceof AuthorizationException) {
              return ResponseEntity.status(403).body(realException.getMessage());
          }
          // 其余异常默认处理
          return ResponseEntity.status(500).body("系统内部错误");
      }
  }
  

受检异常抛出的注意事项 #

Spring AOP本身不限制抛出受检异常，但需要遵守两个规则：

• 抛出的受检异常必须在被拦截目标方法的throws声明中存在，否则无论用JDK还是CGLIB代理，都会出现上层调用方无法正常捕获、或者被代理层包装的问题
• CGLIB代理基于子类实现，重写目标方法时不能抛出比目标方法声明范围更宽泛的受检异常，否则代理类生成失败

内容的提问来源于stack exchange，提问作者Boldbayar