SpringBoot web项目中使用@ExceptionHandler处理全局异常？或是使用HandlerExceptionResolver？哪种更合适

在Spring Boot项目中，使用@ExceptionHandler（结合@ControllerAdvice）和HandlerExceptionResolver两种方式处理全局异常各有适用场景，需根据具体需求权衡。

以下从技术原理、优缺点、适用场景三方面对比分析：

1. @ExceptionHandler + @ControllerAdvice

技术原理

• @ExceptionHandler：标注在方法上，用于捕获Controller中抛出的指定异常类型，返回自定义响应（如JSON）。
• @ControllerAdvice：全局异常处理器注解，可将多个@ExceptionHandler方法集中到一个类中，作用于所有Controller。

优点

• 配置简单：通过注解即可实现，无需复杂接口实现。
• 精准控制：可针对不同异常类型（如NullPointerException、CustomException）编写不同处理逻辑，返回结构化错误信息（如HTTP状态码、错误码、消息）。
• 与Spring MVC深度集成：天然支持Spring的响应式编程模型（如返回ResponseEntity），适合RESTful API场景。
• 代码可读性高：异常处理方法与业务逻辑分离，符合单一职责原则。

缺点

• 仅处理Controller层异常：无法捕获Service层或其他非Controller层抛出的异常（需配合AOP或其他机制）。
• 优先级问题：若多个@ControllerAdvice存在，需通过@Order注解指定优先级，否则可能因加载顺序导致意外覆盖。

2. HandlerExceptionResolver

技术原理

• 接口定义：Spring MVC提供的异常解析接口，需实现resolveException方法，自定义异常处理逻辑。
• 执行顺序：在DispatcherServlet处理请求过程中，若Controller抛出异常，会先尝试@ExceptionHandler，未处理则调用HandlerExceptionResolver。

优点

• 全局拦截：可捕获整个应用上下文（包括Service层、DAO层）的异常，覆盖范围更广。
• 灵活控制：可实现复杂逻辑（如日志记录、邮件通知、重试机制），甚至根据异常类型跳转不同视图（如JSP页面）或返回不同响应。
• 与Spring MVC流程深度集成：可获取请求、响应、模型等对象，进行更底层的操作。

缺点

• 配置复杂：需手动实现接口，编写较多样板代码。
• 维护成本高：逻辑分散在多个实现类中，可读性较差。
• 与@ExceptionHandler优先级冲突：若同时存在，@ExceptionHandler优先处理，可能导致HandlerExceptionResolver逻辑不生效。

3. 对比总结与选择建议

对比维度	@ExceptionHandler + @ControllerAdvice	HandlerExceptionResolver
适用场景	RESTful API、结构化错误响应、Controller层异常	全局异常拦截、复杂处理逻辑、非Controller层异常
配置复杂度	低（注解驱动）	高（需实现接口）
扩展性	中（通过继承/组合扩展）	高（可完全自定义逻辑）
与Spring集成度	高（天然支持响应式模型）	中（需手动处理响应）
代码可维护性	高（逻辑集中，可读性强）	低（逻辑分散，需理解Spring MVC流程）

选择建议

• 优先使用@ExceptionHandler + @ControllerAdvice：
  适用于大多数Spring Boot项目，尤其是RESTful API场景。它简单、直观，能满足Controller层异常处理需求，且与Spring的响应式编程模型无缝集成。例如：

  /**
   * 全局异常处理器，用于捕获和处理应用程序中的自定义异常。
   */
  @ControllerAdvice
  public class GlobalExceptionHandler {
      /**
       * 处理CustomException类型的异常，返回标准化的错误响应。
       * @param e 捕获的自定义异常
       * @return 包含错误码和错误信息的响应实体
       */
      @ExceptionHandler(CustomException.class)
      public ResponseEntity<ErrorResponse> handleCustomException(CustomException e) {
          return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                  .body(new ErrorResponse(e.getErrorCode(), e.getMessage()));
      }
  }
   
  

• 选择HandlerExceptionResolver的场景：

  • 需要捕获Service层、DAO层等非Controller层的异常。
  • 需要实现复杂逻辑（如异常重试、多通道通知、动态路由到不同视图）。
  • 项目已存在基于HandlerExceptionResolver的遗留代码，需保持兼容性。

4. 最佳实践：混合使用

Spring Boot支持混合使用两种方式，优先级为：@ExceptionHandler > HandlerExceptionResolver。

• 推荐方案：
  • 使用@ControllerAdvice处理Controller层常见异常（如参数校验、业务异常）。
  • 通过HandlerExceptionResolver捕获全局未处理的异常（如系统级错误），并记录日志、发送告警等。
    示例：

public class CustomExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, 
                                        HttpServletResponse response, 
                                        Object handler, 
                                        Exception ex) {
        // 处理未被@ExceptionHandler捕获的异常（如数据库连接失败）
        log.error("Global exception: ", ex);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        return new ModelAndView("error");
    }
}

结论：在Spring Boot项目中，@ExceptionHandler + @ControllerAdvice是更优的选择，因其简单、高效、与Spring MVC深度集成。仅在需要全局拦截或复杂逻辑时，才考虑补充HandlerExceptionResolver。