SpringBoot配置全局异常处理器捕获异常详解

1.前言

任何系统，我们不会傻傻的在每一个地方进行异常捕获和处理，整个系统一般我们会在一个的地方统一进行异常处理，spring boot全局异常处理很简单；

前后端分离，后端API，一般对于异常处理，要做得无非两件事，

1.是记录日志及相应通知处理，这是对内的，

2.是给出返回结果给API调用者，这是对外的；

对API调用者来说，他只需要一个返回结果（包含错误代码、提示信息），其他的他不关心

对后端来说，他只需要记录日志，通知或者给发布相应消息给其他队列处理相关事项；

所以：看到过不少人封装了很多个自定义异常类，其实，完全没有必要，只需要一个异常处理来处理所有异常即可，然后封装一个错误识别码和提示消息的枚举，用于返回给API调用者；然后后端的处理，直接在一个异常处理方法中全部处理就行了，完全没必要封装N多个自定义异常，那没有任何意义；

关于异常的思想认识

我们应该认识到，一切异常，对系统来说，都是不正常的表现，都是属于缺陷，都属于BUG，尽管有些异常是我们主动抛出的；

我们要做的，是应该尽量提高系统可用性，最大限度避免任何异常的出现，而不是去指望完善异常处理来完善系统；

异常处理，是异常无法避免的出现了而采取的一种应急措施，主要目的是对外增加友好性，对内提供补救线索；

不要认为完善的异常处理是系统核心，他不是，不要指望异常处理尽善尽美，不要指望异常处理来给系统缺陷擦屁股；

如果系统异常过多，那么你要做的不是去完善异常处理机制，而是要好好去反思：系统架构设计是否合理，系统逻辑设计是否合理；

2.全局异常并处理的方法一（@ControllerAdvice 和 @ExceptionHandler）

=================================================

在开发中，我们会有如下的场景：某个接口中，存在一些业务异常。例如用户输入的参数校验失败、用户名密码不存在等。当触发这些业务异常时，我们需要抛出这些自定义的业务异常，并对其进行处理。一般我们要把这些异常信息的状态码和异常描述，友好地返回给调用者，调用者则利用状态码等信息判断异常的具体情况。

过去，我们可能需要在 controller 层通过 try/catch 处理。首先 catch 自定义异常，然后 catch 其它异常。对于不同的异常，我们需要在 catch 的同时封装将要返回的对象。然而，这么做的弊端就是代码会变得冗长。每个接口都需要做 try/catch 处理，而且一旦需要调整，所有的接口都需要修改一遍，非常不利于代码的维护，如下段代码所示

@RequestMapping (value = "/test")
public ResponseEntity test() {
   ResponseEntity re = new ResponseEntity();
   // 业务处理
   // ...
   try {
       // 业务
   } catch (BusinessException e) {
       logger.info("业务发生异常，code:" + e.getCode() + "msg:" + e.getMsg());
       re.setCode(e.getCode());
       re.setMsg(e.getMsg());
       return re;
   } catch (Exception e) {
       logger.error("服务错误:", e);
       re.setCode("xxxxx");
       re.setMsg("服务错误");
       return re;
   }
   return re;
}

那么，有没有什么方法可以简便地处理这些异常信息呢？答案是肯定的。Spring 3.2 中，新增了 @ControllerAdvice 注解，可以用于定义 @ExceptionHandler 、 @InitBinder 、@ModelAttribute ，并应用到所有 @RequestMapping 中。简单来说就是，可以通过@ControllerAdvice 注解配置一个全局异常处理类，来统一处理 controller 层中的异常，于此同时 controller 中可以不用再写 try/catch，这使得代码既整洁又便于维护。

使用方法

定义自定义异常

有关自定义异常相关知识点这里就不详细说明了，如果不了解的话自行搜索一下。这里贴上一个简单的自定义业务异常类。

/**
* 自定义业务异常类
*
* @author Yuzhe Ma
* @date 2018/11/28
*/
@Data
public class BusinessException extends RuntimeException {
   private String code;
   private String msg;

public BusinessException(String code, String msg) {
       this.code = code;
       this.msg = msg;
   }
}

注： @Data 为 Lombok 插件。自动生成 set/get 方法。具体使用方法这里就不展开介绍了。

@ControllerAdvice + @ExceptionHand` 配置全局异常处理类

/**
* 全局异常处理器
*
* @author Yuzhe Ma
* @date 2018/11/12
*/
@ControllerAdvice
public class GlobalExceptionHandler {
   private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

/**
    * 处理 Exception 异常
    *
    * @param httpServletRequest httpServletRequest
    * @param e                  异常
    * @return
    */
   @ResponseBody
   @ExceptionHandler(value = Exception.class)
   public ResponseEntity exceptionHandler(HttpServletRequest httpServletRequest, Exception e) {
       logger.error("服务错误:", e);
       return new ResponseEntity("xxx", "服务出错");
   }

/**
    * 处理 BusinessException 异常
    *
    * @param httpServletRequest httpServletRequest
    * @param e                  异常
    * @return
    */
   @ResponseBody
   @ExceptionHandler(value = BusinessException.class)
   public ResponseEntity businessExceptionHandler(HttpServletRequest httpServletRequest, BusinessException e) {
       logger.info("业务异常。code:" + e.getCode() + "msg:" + e.getMsg());
       return new ResponseEntity(e.getCode(), e.getMsg());
   }
}

@ControllerAdvice

定义该类为全局异常处理类。

@ExceptionHandler

定义该方法为异常处理方法。value 的值为需要处理的异常类的 class 文件。在例子中，方法传入两个参数。一个是对应的 Exception 异常类，一个是 HttpServletRequest 类。当然，除了这两种参数，还支持传入一些其他参数。详见文档 https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/web/bind/annotation/ExceptionHandler.html

这样，就可以对不同的异常进行统一处理了。通常，为了使 controller 中不再使用任何 try/catch，也可以在 GlobalExceptionHandler 中对 Exception 做统一处理。这样其他没有用 @ExceptionHandler 配置的异常就都会统一被处理。

遇到异常时抛出异常即可

在业务中，遇到业务异常的地方，直接使用 throw 抛出对应的业务异常即可。例如

throw new BusinessException("3000", "账户密码错误");

在 Controller 中的写法

Controller 中，不需要再写 try/catch，除非特殊用途。

@RequestMapping(value = "/test")
public ResponseEntity test() {
   ResponseEntity re = new ResponseEntity();
   // 业务处理
   // ...
   return re;
}

结果展示

异常抛出后，返回如下结果。

{
   "code": "3000",
   "msg": "账户密码错误",
   "data": null
}

注意 不一定必须在 controller 层本身抛出异常才能被 GlobalExceptionHandler 处理，只要异常最后是从 contoller 层抛出去的就可以被全局异常处理器处理。异步方法中的异常不会被全局异常处理。抛出的异常如果被代码内的 try/catch 捕获了，就不会被 GlobalExceptionHandler 处理了。总结

本文介绍了在 SpringBoot 中，通过配置全局异常处理器统一处理 Controller 层引发的异常。

优点

减少代码冗余，代码便于维护

缺点

只能处理 controller 层抛出的异常，对例如 Interceptor（ * ）层的异常、定时任务中的异常、异步方法中的异常，不会进行处理。

来源：https://blog.csdn.net/qq_42768827/article/details/126594405