如何实现兼容自定义与默认异常类型的@ExceptionHandler？

核心思路 #

Spring MVC的@ExceptionHandler按异常类型的精确匹配优先级工作：越具体的异常类型，对应的处理器方法优先级越高。你可以利用这个规则实现「优先处理自定义异常，同时覆盖框架异常」的需求，以下是两种可行方案：

方案1：拆分两个独立处理器方法（推荐） #

这种方式职责清晰，完全符合Spring设计逻辑，自动处理优先级：

// 优先级最高：专门处理自定义异常
@ExceptionHandler(MyCustomException.class)
public ResponseEntity<Object> handleCustomException(MyCustomException exception) {
    // 自定义异常专属处理逻辑
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(exception.getCustomErrorMessage());
}

// 处理框架抛出的异常，覆盖原有默认逻辑
@ExceptionHandler(SomeWebFrameworkException.class)
public ResponseEntity<Object> handleFrameworkException(SomeWebFrameworkException exception) {
    // 框架异常统一处理逻辑
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("框架错误：" + exception.getMessage());
}

当系统抛出MyCustomException时，Spring会优先匹配第一个方法；抛出SomeWebFrameworkException时，匹配第二个方法，完全满足需求。

方案2：单个方法兼容两种异常（适合逻辑高度相似场景） #

如果两种异常处理逻辑差异不大，可在同一方法中通过类型判断实现分支处理：

@ExceptionHandler({MyCustomException.class, SomeWebFrameworkException.class})
public ResponseEntity<Object> handleAllExceptions(Exception exception) {
    if (exception instanceof MyCustomException) {
        // 自定义异常处理分支
        MyCustomException customEx = (MyCustomException) exception;
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(customEx.getCustomDetail());
    } else if (exception instanceof SomeWebFrameworkException) {
        // 框架异常处理分支
        SomeWebFrameworkException frameworkEx = (SomeWebFrameworkException) exception;
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(frameworkEx.getMessage());
    }
    // 兜底处理其他未明确指定的异常
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("未知错误");
}

你之前的写法无效原因 #

1. 第一个写法：@ExceptionHandler指定SomeWebFrameworkException，但方法参数是MyCustomException，类型不匹配，Spring无法将框架抛出的异常注入参数，导致处理器失效。
2. 第二个多参数写法：@ExceptionHandler方法只能接收一个异常类型参数（一次请求只会抛出一个异常），同时声明两个异常参数不符合Spring参数注入规则，因此无法生效。

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