为何CustomResponseEntity仅捕获通用异常而非InvalidRequestTypeException？

嘿，我来帮你梳理下这个问题！你遇到的情况在Spring异常处理场景里挺常见的，大概率是几个容易忽略的细节导致InvalidRequestTypeException没被正确匹配到对应的处理器，咱们挨个排查：

1. 先确认自定义异常真的被抛出了 #

先去客户端代码里加个日志，在抛出InvalidRequestTypeException的地方打印异常类型，确保这里真的抛出了你的自定义异常，而不是被上层的try-catch块捕获后转成了通用Exception——这种情况太常见了：

// 抛出前先打印确认
InvalidRequestTypeException ex = new InvalidRequestTypeException("无效的请求类型");
System.out.println("实际抛出的异常类型：" + ex.getClass().getName());
throw ex;

重点检查有没有父方法用catch(Exception e)把你的自定义异常吞掉，然后又抛出了新的通用异常。

2. 检查异常处理器的方法配置 #

如果你的处理器是Spring全局异常处理器（用@RestControllerAdvice或@ControllerAdvice注解），一定要确认处理自定义异常的方法签名完全正确：

• 必须在@ExceptionHandler里明确指定你的自定义异常类
• 方法参数必须是InvalidRequestTypeException类型，不能写成Exception或它的父类
• 处理器类要被Spring扫描到（比如在启动类的包扫描范围内，或加了@Component注解）

正确的示例应该是这样：

@RestControllerAdvice
public class CustomResponseEntityExceptionHandler {

    // 处理自定义异常
    @ExceptionHandler(InvalidRequestTypeException.class)
    public ResponseEntity<ErrorResponse> handleInvalidRequestType(InvalidRequestTypeException ex) {
        log.info("捕获到InvalidRequestTypeException");
        return ResponseEntity.badRequest().body(new ErrorResponse(ex.getMessage()));
    }

    // 处理通用异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGenericException(Exception ex) {
        log.info("捕获到通用Exception");
        return ResponseEntity.internalServerError().body(new ErrorResponse("服务器错误"));
    }
}

3. 检查自定义异常的继承关系 #

如果你的InvalidRequestTypeException继承的是受检异常（Exception），而不是运行时异常（RuntimeException），那你的控制器方法必须声明throws InvalidRequestTypeException，否则Spring会把它包装成UndeclaredThrowableException，导致你的处理器抓不到原始异常。

解决办法二选一：

• 让自定义异常继承RuntimeException：

  public class InvalidRequestTypeException extends RuntimeException {
      // 构造方法实现
  }
  

• 在控制器方法上添加throws InvalidRequestTypeException声明。

4. 检查异常处理器的优先级 #

如果有多个异常处理器类，或者同一个类里的处理器顺序有问题，Spring会优先匹配最具体的异常类型，但如果你的自定义异常处理器被其他通用处理器“抢”了先，也会出现这个问题。

可以用@Order注解调整顺序，让自定义异常处理器的优先级更高：

@RestControllerAdvice
@Order(1) // 数字越小优先级越高
public class CustomResponseEntityExceptionHandler {
    // ... 你的处理器方法
}

5. 排查是否有AOP/过滤器拦截了异常 #

如果项目里有AOP切面或者全局过滤器，它们可能会捕获异常并重新抛出通用异常。比如某个日志切面在捕获异常后，又抛了个new Exception(ex.getMessage())，这就会把你的自定义异常转换成通用异常，导致处理器抓不到。

可以暂时禁用这些切面/过滤器，测试自定义异常能不能被正确捕获。

快速验证步骤 #

1. 直接在某个控制器方法里手动抛出InvalidRequestTypeException，看处理器能不能捕获到——如果能，说明问题出在客户端代码的抛出逻辑上；如果不能，说明问题在处理器本身。
2. 打印异常的完整栈轨迹，看异常在传递过程中有没有被包装或转换。

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