通用技术 Java 代码中的全局异常处理

小敏 · 2018年02月27日 · 最后由在路上回复于 2018年02月28日 · 5970 次阅读

最近接手一个新项目，写用例的时候去翻看代码，发现部分代码里缺少基本的异常处理，包括对参数异常以及业务异常的处理。对照之前负责过的异常处理做得比较好的项目，给开发提了几点建议，顺便又去翻看了之前项目的代码，对常用的异常处理方式做了一个梳理。

1 Java 异常分类

Java 把异常当做对象来处理。Throwable 是所有错误或异常的超类。Throwable 类有两个直接子类：Error 类和 Exception 类。
1、Error 是指 java 运行时系统的内部错误和资源耗尽错误，是程序无法处理的异常，应用程序不会抛出该类对象。
2、Exception 是程序本身可以处理的异常，应尽可能去处理这些异常。Exception 分两类，一个是运行时异常 RuntimeException，一个是检查异常 CheckedException。
3、CheckedException 一般是外部错误，这种异常都发生在编译阶段，Java 编译器会强制程序去捕获此类异常。
4、RuntimeException 是那些可能在 Java 虚拟机正常运行期间抛出的异常的超类。这种错误是由程序员引起的错误，可以修正代码解决。

2 用@ControllerAdvice+@ExceptionHandler实现全局异常处理

通常在 Controller 层需要去捕获 service 层的异常，防止返回一些不友好的错误信息到客户端，但如果 Controller 层每个方法都用模块化的 try-catch 代码去捕获异常，会很难看也难维护。
异常处理最好是解耦的，并且都放在一个地方集中管理。Spring 能够较好的处理这种问题，核心如下，这里主要关注前两个：
@ExceptionHandler：统一处理某一类异常，从而能够减少代码重复率和复杂度
@ControllerAdvice：异常集中处理，更好的使业务逻辑与异常处理剥离开
@ResponseStatus：可以将某种异常映射为 HTTP 状态码

单使用@ExceptionHandler，只能在当前 Controller 中处理异常，与@ControllerAdvice组合使用，则可以实现全局异常处理，不用每个 controller 都配置。

2.1 全局异常处理类

下面通过一个实际项目代码来看一下@ControllerAdvice+@ExceptionHandler的使用。
@ControllerAdvice定义全局异常处理类 GlobalExceptionHandler
@ExceptionHandler声明异常处理方法，使用 value 指定异常类，value = Exception.class 表示处理 Controller 层抛出的 Exception 及其子类的异常，这样 Controller 层代码就不需要进行异常处理了。

GlobalExceptionHandler 类中对多个异常进行了处理，这些异常分两类，一类是自定义异常，如 AuthenticationException、BadRequestException，一类是非自定义异常，如 HttpRequestMethodNotSupportedException、TypeMismatchException 等。

2.2 自定义异常

一般项目中都会有一些业务相关（非 JVM 抛出）的异常，可以使用自定义异常继承相关的异常来抛出有用的异常信息，其类名要能体现具体的异常信息，这样根据异常名就可以知道哪里有异常，根据异常提示信息进行程序修改。比如空指针异常 NullPointException，可以抛出 message 为 “xxx 为空” 定位异常位置，而不用输出堆栈信息。

自定义异常通常是定义一个继承自 Exception 类的子类，一般会直接继承自 Exception 类，而不会继承某个运行时的异常类。

下面是项目代码中自定义异常的使用。
定义自定义异常类 AuthenticationException，继承 Exception 类：

在 Service 层抛出 AuthenticationException：

2.3 数据校验异常处理

代码中可以使用@RequestBody+@Valid进行数据绑定和数据校验。
下面是项目代码中对 Post 请求表单的处理，通过@RequestBody将请求 body 中的 json 与表单对象（CreateOrderRequestVO）绑定，使用@Valid进行表单验证。如果不使用@Valid，CreateOrderRequestVO 中的@NotNull等注解不生效。