引言
在 Web 开发中，异常处理是保障系统健壮性和用户体验的关键环节。Spring MVC 提供了多种异常处理机制，其中 HandlerExceptionResolver 是一个强大且灵活的底层工具。本文将深入探讨它的工作原理、使用场景、实战技巧，并通过具体代码示例展示如何全局统一处理异常。
什么是 HandlerExceptionResolver？
HandlerExceptionResolver 是 Spring MVC 中用于统一处理控制器方法执行过程中抛出异常的接口。它允许开发者将异常转换为特定的 HTTP 响应，例如：
-
跳转到自定义错误页面（HTML）
-
返回结构化的错误 JSON（API 接口）
-
设置 HTTP 状态码（如 404、500）
通过实现该接口，可以集中管理所有异常，避免在每个控制器中重复编写 try-catch 代码。
核心方法与处理流程：
java
ModelAndView resolveException(
HttpServletRequest request,
HttpServletResponse response,
Object handler,
Exception ex
);-
参数：
-
request、response：操作 HTTP 请求和响应。 -
handler：触发异常的控制器方法。 -
ex：抛出的异常对象。
-
-
返回值：
ModelAndView：封装视图和数据，若返回null则表示未处理异常，由其他解析器继续处理。
处理流程
-
控制器方法抛出异常。
-
Spring MVC 遍历所有注册的
HandlerExceptionResolver。 -
第一个能处理该异常的解析器（返回非
null）终止流程。 -
若所有解析器均未处理，则交由容器默认处理（如 Tomcat 的 Whitelabel 错误页）
自定义 HandlerExceptionResolver 实战
场景需求
假设项目中需实现以下异常处理逻辑：
-
Web 请求：跳转到美观的错误页面，并显示友好提示。
-
API 请求：返回 JSON 格式的错误信息，包含错误码和消息。
-
特定异常 ：如
BusinessException需记录日志并返回自定义 HTTP 状态码。
代码实现
1. 创建自定义解析器
java
public class GlobalExceptionResolver implements HandlerExceptionResolver, Ordered {
@Override
public ModelAndView resolveException(
HttpServletRequest request,
HttpServletResponse response,
Object handler,
Exception ex) {
// 判断请求类型：API 或 Web
boolean isApiRequest = request.getRequestURI().startsWith("/api/")
|| "application/json".equals(request.getHeader("Accept"));
if (isApiRequest) {
return handleApiException(response, ex);
} else {
return handleWebException(ex);
}
}
private ModelAndView handleApiException(HttpServletResponse response, Exception ex) {
try {
response.setContentType("application/json");
response.setStatus(500); // 默认状态码
// 构建 JSON 响应体
Map<String, Object> error = new HashMap<>();
error.put("code", 500);
error.put("message", "服务异常，请稍后重试");
// 针对特定异常细化处理
if (ex instanceof BusinessException) {
BusinessException bex = (BusinessException) ex;
error.put("code", bex.getCode());
error.put("message", bex.getMessage());
response.setStatus(bex.getHttpStatus().value());
}
// 写入响应流
response.getWriter().write(new ObjectMapper().writeValueAsString(error));
} catch (IOException e) {
e.printStackTrace();
}
return new ModelAndView(); // 返回空表示已处理
}
private ModelAndView handleWebException(Exception ex) {
ModelAndView mav = new ModelAndView("error-page"); // 模板路径
mav.addObject("errorMsg", ex.getMessage());
// 记录日志
log.error("Web请求异常: ", ex);
return mav;
}
@Override
public int getOrder() {
return Ordered.HIGHEST_PRECEDENCE; // 最高优先级
}
}2. 注册解析器
java
@Configuration
public class WebMvcConfig {
@Bean
public HandlerExceptionResolver globalExceptionResolver() {
return new GlobalExceptionResolver();
}
}3. HTML 错误页模板（Thymeleaf）
resources/templates/error-page.html：
java
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<title>错误提示</title>
</head>
<body>
<h1>抱歉，系统开小差了！</h1>
<p th:text="${errorMsg}"></p>
<a href="/">返回首页</a>
</body>
</html>高级技巧与最佳实践
1. 优先级控制
通过实现 Ordered 接口或使用 @Order 注解，确保自定义解析器优先于 Spring 默认解析器执行。例如：
java
@Override
public int getOrder() {
return Ordered.HIGHEST_PRECEDENCE; // 值越小，优先级越高
}2. 异常日志记录
在解析器中统一记录异常日志，便于问题排查：
java
@Override
public ModelAndView resolveException(...) {
log.error("请求路径: {}, 异常信息: {}", request.getRequestURI(), ex.getMessage(), ex);
// ...处理逻辑
}3. 区分异常类型
针对不同异常定制处理逻辑，提升用户体验：
java
if (ex instanceof ResourceNotFoundException) {
response.setStatus(404);
error.put("message", "请求的资源不存在");
} else if (ex instanceof AccessDeniedException) {
response.setStatus(403);
error.put("message", "无权访问");
}与 @ControllerAdvice 对比：
| 特性 | HandlerExceptionResolver |
@ControllerAdvice + @ExceptionHandler |
|---|---|---|
| 灵活性 | 更底层，可完全控制处理流程 | 基于注解，较为简洁 |
| 适用场景 | 需要动态判断响应类型（如 HTML/JSON） | 同一异常类型固定返回一种响应格式 |
| 代码侵入性 | 需手动注册解析器 | 无侵入，通过注解声明 |
| 优先级控制 | 通过 Ordered 接口精细控制 |
默认按 @Order 注解或 Bean 顺序 |
总结
HandlerExceptionResolver 是 Spring MVC 异常处理的底层核心机制，适合需要高度定制异常响应的场景。通过本文的实例，你可以快速掌握：
-
如何区分 Web 和 API 请求返回不同格式的错误信息
-
如何结合日志记录、异常分类提升系统可维护性
-
灵活控制处理优先级和响应细节
尽管现代 Spring 项目中更推荐使用 @ControllerAdvice（代码更简洁），但在需要动态处理逻辑（如多端适配、第三方库异常转换）时，HandlerExceptionResolver 仍是不可或缺的利器。