如何让Spring的@ExceptionHandler与其他异常处理机制协同工作？

代码与测试情况 #

REST端点代码 #

@GetMapping("/whatever/{userId}")
MyResponse fetchStuff(@PathVariable("userId") long userId) {
    return new MyResponse();
}

@GetMapping("/list")
List<String> fetchList() {
     throw new ResponseStatusException(HttpStatus.NO_CONTENT, "No data found");
}

全局异常处理器代码 #

@ExceptionHandler(Exception.class )
ResponseEntity<String> handleException(Exception e) {
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
            .header(HttpHeaders.CONTENT_TYPE, MediaType.TEXT_PLAIN_VALUE).body(e.getMessage());
}

失败的测试用例 #

@Test
void should_return_400_if_userId_is_alphanumeric() throws Exception {
    mockMvc.perform(get("/whatever/{userId}", "ABC")
        .andExpect(status().isBadRequest());
    }
}

@Test
void should_return_204() throws Exception {
    mockMvc.perform(get("/list")
        .andExpect(status().isNoContent());
    }
}

问题描述 #

上述测试均失败：第一个测试中Spring自动抛出的MethodArgumentNotValidException、第二个测试手动抛出的ResponseStatusException，都被全局Exception.class处理器捕获，返回了500错误，不符合预期（前者应返回400，后者应返回204）。

用户疑问：

1. 此处全局异常处理器的意义何在？
2. 有无无需为大量异常编写@ExceptionHandler的解决方案？

问题解答 #

一、全局Exception.class异常处理器的意义 #

• 兜底容错：捕获所有未被更具体异常处理器处理的异常，避免Spring返回默认的无意义错误页面或信息，统一错误返回格式，保证客户端能收到规范的响应。
• 统一日志：可以在此处理器中集中记录所有未捕获异常的日志，方便后续问题排查。
• 安全防护：避免将异常栈等敏感信息直接返回给客户端，降低信息泄露风险。

但它的弊端就是会覆盖Spring自带的特定异常处理逻辑，比如ResponseStatusException本身会自动映射到指定状态码，MethodArgumentNotValidException默认返回400状态码，这也是测试失败的原因。

二、无需编写大量@ExceptionHandler的解决方案 #

方案1：调整全局处理器范围，放行Spring自带异常

修改全局处理器，只处理自定义业务异常，对Spring自带的特定异常重新抛出，交给默认处理器处理：

@ExceptionHandler(RuntimeException.class)
ResponseEntity<String> handleRuntimeException(RuntimeException e) {
    // 放行Spring需要特殊处理的异常
    if (e instanceof ResponseStatusException || e instanceof MethodArgumentNotValidException) {
        throw e;
    }
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
            .header(HttpHeaders.CONTENT_TYPE, MediaType.TEXT_PLAIN_VALUE)
            .body(e.getMessage());
}

这样既保留了兜底处理能力，又让MethodArgumentNotValidException返回400、ResponseStatusException返回指定状态码，测试就能正常通过。

方案2：仅处理自定义业务异常

定义一个专属的业务异常类，全局处理器只处理该异常，Spring自带的异常交给默认处理器处理：

// 自定义业务异常
public class BusinessException extends RuntimeException {
    public BusinessException(String message) {
        super(message);
    }
}

// 全局处理器
@ExceptionHandler(BusinessException.class)
ResponseEntity<String> handleBusinessException(BusinessException e) {
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
            .header(HttpHeaders.CONTENT_TYPE, MediaType.TEXT_PLAIN_VALUE)
            .body(e.getMessage());
}

这种方式最清晰，既不会干扰Spring的默认异常处理逻辑，也无需为每个框架异常编写处理器，只需要关注业务层面的异常即可。

方案3：调整异常处理器优先级（不推荐）

如果一定要保留Exception.class的全局处理器，可以通过自定义HandlerExceptionResolver并调整优先级，让Spring默认的异常处理器（如ResponseStatusExceptionResolver）优先执行。但这种方式配置复杂，日常开发中很少用到，前两种方案更简洁实用。

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