Java 代码中的全局异常处理

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

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等注解不生效。

 

在表单对象CreateOrderRequestVO类的相应字段上添加用于充当校验条件的注解（@NotNull、@NotBlank、@Min等）。

 

数据校验失败时，Spring MVC 框架会抛出 MethodArgumentNotValidException 异常， 在 GlobalExceptionHandler 中加上对 MethodArgumentNotValidException 异常的声明和处理，就可以全局处理数据校验的异常了。

小结

本文主要是基于项目代码，对其中的全局统一异常处理做了一个梳理和总结。这种异常处理方式将异常处理从业务代码中解耦出来，实现异常信息的统一处理和维护，减少了模板代码，改善了代码的风格。

在日常测试中，有意识地多学习一些开发代码中写得好的地方，为自己以后写代码不断积累经验，还可以适时地对开发的代码提出一些建议。