Spring MVC 中的统一异常处理

Spring MVC 中跳转自定义 404 页面的两种常见方式

在 web.xml 中指定自定义的 404 页面

<error-page><error-code>404</error-code><location>/WEB-INF/jsp/404.jsp</location>
</error-page>

提供一个匹配 * 的 Controller 请求处理方法

// 凡是不能精确匹配的 url，都会由这个请求处理方法处理
@RequestMapping("*")
public String error404() {return "404";
}

使用 @ExceptionHandler 注解

@ExceptionHandler 注解用于标注于某个 Controller 的方法上，例如：

@Controller      
public class GlobalController {               /**    * 用于处理异常的*/      @ExceptionHandler({AException.class, BException.class, ...})       public String exception(MyException e) {    ...}@RequestMapping("test1")       public void test2() {...}@RequestMapping("test2")       public void test2() {...}
}

当 Controller 的请求方法发生指定异常时，@ExceptionHandler 所标注的方法将会被执行。返回给服务器的数据也就由该方法的返回值决定。

@ExceptionHandler 所标注的方法的常见参数有以下几种：

• 一个异常参数。代表所发生的异常（最常用）

• HttpServletRequest / HttpServletResponse 对象

• HttpSession 对象

• Model 对象

• 等等。

@ExceptionHandler 所标注的方法的返回值的类型支持：

• ModelAndView 对象（最常用）

• Model 对象

• Map 对象

• View 对象

• 被解析成一个视图名称的 String 值（次常用）

• 等等

另外，可以将 @ResponseStatus 与 @ExceptionHandler 结合使用，来定义 HTTP 响应的响应状态。

可以看到，这种方式最大的缺陷就是不能全局控制异常。每个类都要写一遍。

使用 @ControllerAdvice + @ExceptionHandler 注解

@ExceptionHandler 需要进行异常处理的方法必须与出错的方法在同一个 Controller 里面。那么当代码加入了 @ControllerAdvice，则不需要必须在同一个 controller 中了。

这也是 Spring 3.2 带来的新特性。从名字上可以看出大体意思是控制器增强。

使用示例

请确保此 WebExceptionHandle 类能被扫描到并装载进 Spring 容器中。由于标注了 @ControllerAdvice 注解，在开启了包扫描的情况下，Spring 会创建该类的单例对象。

@Slf4j
@ControllerAdvice(assignableTypes = FirstController.class)
public class FirstControllerExceptionHandler {@ExceptionHandler(IllegalArgumentException.class)public String demo1(Exception e) {log.warn("IllegalArgumentException");return "";}@ExceptionHandler(NullPointerException.class)public String demo(Exception e) {log.warn("NullPointerException");return "";}
}

上述方法中的参数对象就是 Controller 层抛出的异常对象。注意，该方法如果有第二个参数，那么该机制会失效，无法捕获-处理 Controller 抛出的异常！

控制生效的 Controller 范围

注意到，我是这样编写注解的：

@ControllerAdvice(assignableTypes = { FirstController.class })

它用来限定这些异常处理函数起作用的 Controller 的范围。如果不写，则默认对所有 Controller 有效。

这也是 ControllerAdvice 进行统一异常处理的优点，它能够细粒度的控制该异常处理器针对哪些 Controller 有效，这样的好处是：

1. 一个系统里就能够存在不同的异常处理器，Controller 也可以有选择的决定使用哪个，更加灵活。

2. 不同的业务模块可能对异常处理的方式不同，通过该机制就能做到。

3. 设想一个一开始并未使用全局异常处理的系统，如果直接引入全局范围内生效的全局异常处理，势必可能会改变已有 Controller 的行为，有侵入性。
   也就是说，如果不控制生效范围，即默认对所有 Controller 生效。如果控制生效范围，则默认对所有 Controller 不生效，降低侵入性。

ControllerAdvice 支持的限定范围：

1. 按注解：@ControllerAdvice(annotations = RestController.class)

2. 按包名：@ControllerAdvice(“org.example.controllers”)

3. 按类型：@ControllerAdvice(assignableTypes = {ControllerInterface.class, AbstractController.class})