Spring Framework MVC 异常处理机制深度解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00946/article/details/148324224

Spring Framework MVC 异常处理机制深度解析

spring-framework spring-projects/spring-framework: 一个基于 Java 的开源应用程序框架，用于构建企业级 Java 应用程序。适合用于构建各种企业级 Java 应用程序，可以实现高效的服务和管理。项目地址: https://gitcode.com/gh_mirrors/sp/spring-framework

异常处理概述

在 Spring MVC 应用中，当请求映射或控制器方法执行过程中发生异常时，DispatcherServlet 会将异常委托给一系列 HandlerExceptionResolver 实现来处理。这套机制为开发者提供了灵活的方式来处理不同类型的异常，并返回适当的响应。

核心异常解析器

Spring MVC 提供了四种主要的异常解析器实现：

SimpleMappingExceptionResolver
- 将异常类名映射到错误视图名
- 适用于需要显示错误页面的传统Web应用
- 可配置异常到视图名的映射关系
DefaultHandlerExceptionResolver
- 处理Spring MVC内部抛出的标准异常
- 将异常转换为对应的HTTP状态码
- 例如：将MissingServletRequestParameterException转换为400 Bad Request
ResponseStatusExceptionResolver
- 处理带有@ResponseStatus注解的异常
- 根据注解中的配置返回相应的HTTP状态码
- 适用于自定义异常的状态码映射
ExceptionHandlerExceptionResolver
- 最灵活的处理方式
- 调用控制器或@ControllerAdvice类中的@ExceptionHandler方法处理异常
- 支持细粒度的异常处理逻辑

解析器链工作机制

多个异常解析器可以组成处理链，通过order属性控制执行顺序（数值越大优先级越低）。解析器处理异常时有三种可能结果：

返回包含错误视图的ModelAndView
返回空的ModelAndView（表示已处理但无需视图）
返回null（表示未处理，交给后续解析器）

Spring MVC自动配置的解析器顺序为：

ExceptionHandlerExceptionResolver
ResponseStatusExceptionResolver
DefaultHandlerExceptionResolver

容器级错误页面

当所有解析器都无法处理异常时，异常会传播到Servlet容器。容器会根据HTTP状态码显示默认错误页面。开发者可以通过以下方式自定义：

在web.xml中配置错误页面映射：

<error-page>
    <location>/error</location>
</error-page>

实现错误处理控制器：

@RestController
public class ErrorController {
    @RequestMapping("/error")
    public Map<String, Object> handleError(HttpServletRequest request) {
        Map<String, Object> errorInfo = new HashMap<>();
        errorInfo.put("status", request.getAttribute("jakarta.servlet.error.status_code"));
        errorInfo.put("message", request.getAttribute("jakarta.servlet.error.message"));
        return errorInfo;
    }
}

最佳实践建议

优先使用@ExceptionHandler：在控制器或@ControllerAdvice类中使用@ExceptionHandler方法，可以获得最大的灵活性。
合理组合使用解析器：对于不同类型的异常，可以组合使用多种解析器。
统一异常处理：通过@ControllerAdvice实现全局异常处理，保持异常响应格式一致。
考虑API和页面的不同需求：REST API通常需要返回JSON错误信息，而传统Web应用可能需要渲染错误页面。
记录异常日志：在处理异常时，确保记录足够的调试信息。