Spring - @ControllerAdvice + @ExceptionHandler全局处理Controller层异常（转）-白红宇

Spring - @ControllerAdvice + @ExceptionHandler全局处理Controller层异常（转）

阅读量：6209 次

发布时间：2019-06-21

本文共 7480 字，大约阅读时间需要 24 分钟。

0.前言

对于与数据库相关的Spring MVC项目，我们通常会把事务配置在 Service层，当数据库操作失败时让Service层抛出运行时异常，Spring事物管理器就会进行回滚。

如此一来，我们的Controller层就不得不进行try-catch Service层的异常，否则会返回一些不友好的错误信息到客户端。但是，Controller层每个方法体都写一些模板化的try-catch的代码，很难看也难维护，特别是还需要对Service层的不同异常进行不同处理的时候。例如以下 Controller 方法代码（非常难看且冗余）：

/**     * 手动处理 Service 层异常和数据校验异常的示例     *     * @param dog     * @param errors     * @return     */    @PostMapping(value = "")    AppResponse add(@Validated(Add.class) @RequestBody Dog dog, Errors errors) {        AppResponse resp = new AppResponse();        try {            // 数据校验            BSUtil.controllerValidate(errors);            // 执行业务            Dog newDog = dogService.save(dog);            // 返回数据            resp.setData(newDog);        } catch (BusinessException e) {            LOGGER.error(e.getMessage(), e);            resp.setFail(e.getMessage());        } catch (Exception e) {            LOGGER.error(e.getMessage(), e);            resp.setFail("操作失败！");        }        return resp;    }

本文讲解使用@ControllerAdvice + @ExceptionHandler进行全局的Controller层异常处理，只要设计得当，就再也不用在 Controller 层进行 try-catch 了。而且，@Validated校验器注解的异常，也可以一起处理，无需手动判断绑定校验结果BindingResult/Errors了。

1.优缺点

优点：将 Controller层的异常和数据校验的异常进行统一处理，减少模板代码，减少编码量，提升扩展性和可维护性。

缺点：只能处理Controller层未捕获（往外抛）的异常，对于 Interceptor（拦截器）层的异常，Spring 框架层的异常，就无能为力了。

2.示例

2.1 @ControllerAdvice 注解定义全局异常处理类

@ControllerAdvicepublic class GlobalExceptionHandler {}

确保此GlobalExceptionHandler类能被扫描到并装载进 Spring 容器中。

2.2 @ExceptionHandler 注解声明异常处理方法

@ControllerAdvicepublic class GlobalExceptionHandler {    @ExceptionHandler(Exception.class)    @ResponseBody    String handleException(){        return "Exception Deal!";    }}

方法handleException()就会处理所有Controller层抛出的Exception及其子类的异常，这是最基本的用法了。

被@ExceptionHandler注解的方法的参数列表里，还可以声明很多种类型的参数，。其原型如下：

@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface ExceptionHandler {    /**     * Exceptions handled by the annotated method. If empty, will default to any     * exceptions listed in the method argument list.     */    Class
        [] value() default {};}

如果@ExceptionHandler注解中未声明要处理的异常类型，则默认为参数列表中的异常类型。所以上面的写法，还可以写成这样，参数对象就是Controller层抛出的异常对象。

@ControllerAdvicepublic class GlobalExceptionHandler {    @ExceptionHandler()    @ResponseBody    String handleException(Exception e){        return "Exception Deal! " + e.getMessage();    }}

3.处理 Service 层上抛的业务异常

封装的业务异常类：

public class BusinessException extends RuntimeException {    public BusinessException(String message){        super(message);    }}

Service 实现类：

@Servicepublic class DogService {    @Transactional    public Dog update(Dog dog){        // some database options        // 模拟狗狗新名字与其他狗狗的名字冲突        BSUtil.isTrue(false, "狗狗名字已经被使用了...");        // update database dog info        return dog;    }}

其中辅助工具类 BSUtil：

public static void isTrue(boolean expression, String error){    if(!expression) {        throw new BusinessException(error);    }}

那么，我们应该在GlobalExceptionHandler类中声明该业务异常类，并进行相应的处理，然后返回给用户。更贴近真实项目的代码，应该长这样子：

/** * @ControllerAdvice + @ExceptionHandler 实现全局的 Controller 层的异常处理 */@ControllerAdvicepublic class GlobalExceptionHandler {    private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);    /**     * 处理所有不可知的异常     * @param e     * @return     */    @ExceptionHandler(Exception.class)    @ResponseBody    AppResponse handleException(Exception e){        LOGGER.error(e.getMessage(), e);        AppResponse response = new AppResponse();        response.setFail("操作失败！");        return response;    }    /**     * 处理所有业务异常     * @param e     * @return     */    @ExceptionHandler(BusinessException.class)    @ResponseBody    AppResponse handleBusinessException(BusinessException e){        LOGGER.error(e.getMessage(), e);        AppResponse response = new AppResponse();        response.setFail(e.getMessage());        return response;    }}

Controller层的代码，就不需要进行异常处理了：

@RestController@RequestMapping(value = "/dogs", consumes = {MediaType.APPLICATION_JSON_UTF8_VALUE})public class DogController {    @Autowired    private DogService dogService;    @PatchMapping(value = "")    Dog update(@Validated(Update.class) @RequestBody Dog dog){        return dogService.update(dog);    }}

Logger 进行所有的异常日志记录。

@ExceptionHandler(BusinessException.class) 声明了对 BusinessException 业务异常的处理，并获取该业务异常中的错误提示，构造后返回给客户端。

@ExceptionHandler(Exception.class) 声明了对 Exception 异常的处理，起到兜底作用，不管 Controller 层执行的代码出现了什么未能考虑到的异常，都返回统一的错误提示给客户端。

备注：以上 GlobalExceptionHandler 只是返回 Json 给客户端，更大的发挥空间需要按需求情况来做。

4.处理 Controller 数据绑定、数据校验的异常

在 Dog 类中的字段上的注解数据校验规则：

@Datapublic class Dog {    @NotNull(message = "{Dog.id.non}", groups = {Update.class})    @Min(value = 1, message = "{Dog.age.lt1}", groups = {Update.class})    private Long id;    @NotBlank(message = "{Dog.name.non}", groups = {Add.class, Update.class})    private String name;    @Min(value = 1, message = "{Dog.age.lt1}", groups = {Add.class, Update.class})    private Integer age;}

说明：

@NotNull、@Min、@NotBlank 这些注解的使用方法，不在本文范围内。如果不熟悉，请查找资料学习即可。

@Data 注解是Lombok项目的注解，可以使我们不用再在代码里手动加getter & setter。

SpringMVC 中对于 RESTFUL 的 Json 接口来说，数据绑定和校验，是这样的：

/** * 使用 GlobalExceptionHandler 全局处理 Controller 层异常的示例 * @param dog * @return */@PatchMapping(value = "")AppResponse update(@Validated(Update.class) @RequestBody Dog dog){    AppResponse resp = new AppResponse();    // 执行业务    Dog newDog = dogService.update(dog);    // 返回数据    resp.setData(newDog);    return resp;}

使用@Validated + @RequestBody注解实现。

当使用了@Validated + @RequestBody注解但是没有在绑定的数据对象后面跟上Errors类型的参数声明的话，Spring MVC框架会抛出MethodArgumentNotValidException异常。

所以，在GlobalExceptionHandler中加上对MethodArgumentNotValidException异常的声明和处理，就可以全局处理数据校验的异常了。加完后的代码如下：

/** * Created by kinginblue on 2017/4/10. * @ControllerAdvice + @ExceptionHandler 实现全局的 Controller 层的异常处理 */@ControllerAdvicepublic class GlobalExceptionHandler {    private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);    /**     * 处理所有不可知的异常     * @param e     * @return     */    @ExceptionHandler(Exception.class)    @ResponseBody    AppResponse handleException(Exception e){        LOGGER.error(e.getMessage(), e);        AppResponse response = new AppResponse();        response.setFail("操作失败！");        return response;    }    /**     * 处理所有业务异常     * @param e     * @return     */    @ExceptionHandler(BusinessException.class)    @ResponseBody    AppResponse handleBusinessException(BusinessException e){        LOGGER.error(e.getMessage(), e);        AppResponse response = new AppResponse();        response.setFail(e.getMessage());        return response;    }    /**     * 处理所有接口数据验证异常     * @param e     * @return     */    @ExceptionHandler(MethodArgumentNotValidException.class)    @ResponseBody    AppResponse handleMethodArgumentNotValidException(MethodArgumentNotValidException e){        LOGGER.error(e.getMessage(), e);        AppResponse response = new AppResponse();        response.setFail(e.getBindingResult().getAllErrors().get(0).getDefaultMessage());        return response;    }}

所有的 Controller 层的异常的日志记录，都是在这个GlobalExceptionHandler 中进行记录。也就是说，Controller层也不需要在手动记录错误日志了。