Spring Boot 全局异常处理（上）

背景

对接的项目多了，奇奇怪怪的问题就都出现了，好比有一个最让人烦心的问题 异常。

偶尔会碰到框架抛出的默认的异常，好比 Laraval，好比 Spring Boot，每一个框架抛出的异常格式是不一致的，有 Json 或 XML 格式的数据，更甚至有 HTML 页面，最为关键的是响应的数据结构和接口约定的数据结构不一致，因此这时候咱们在对响应内容进行解析的时候反而会给咱们本身的代码带来须要处理的异常。

基于此，为了对本身的接口负责，咱们须要进行全局的异常处理，目的是防止出现约定以外的数据结构。

Spring Boot 默认的异常处理机制

默认状况下，Spring Boot 会返回两种类型的异常，一种是 HTML，还有一种是 Json 格式的数据，这主要取决于请求头中的 Accept 参数，好比浏览器发出的请求，请求头中会附带 Accept：text/html，因此此时 Spring Boot 会返回一个错误页面，称为 Whitelabel Error Page，而当咱们使用 Postman 请求时，返回的则是 Json 类型的数据。

原理其实也很简单，Spring Boot 默认提供了程序出错的结果映射路径 /error。而这个 /error 请求会由 BasicErrorController 来处理，其内部其实就是经过判断请求头的 Accept 中的内容来进行区分处理逻辑的（判断是否包含 text/html），从而来决定返回页面视图仍是 JSON 消息内容。

相关 BasicErrorController 中代码以下：

自定义错误页面

自定义错误页面的好处有好多，好比 404 错误页面，咱们彻底能够自定义 404 的 HTML 页面，上面能够放置图片等，这样体验就更友好一点。

自定义的错误页面有两种，一种是 静态页面，一种是使用 模板引擎 动态生成，后者的优点是能够在页面上显示自定义的内容。

• 静态页面的方式，html 文件的路径为：resources/public/error/xxx.html

若是要替换 404 错误页面，则在此路径下放置 404.html 文件，同理，若是要替换 500 错误页面，则在此路径下放置 500.html 文件便可

• 模板引擎渲染的动态页面的方式，html 文件的路径为：resources/templates/error/xxx.html

文件命名同上

注意：动态页面的优先级是要高于静态页面的 好比你同时配置了静态页面和动态页面，那么最终生效的，会是动态页面。

附上文件结构图：

自定义错误信息

上面介绍了最简单的错误处理，最主要的针对返回的 HTML，可是咱们每每也要处理 Json 类型的返回内容，目的是让数据结构和咱们的接口返回的数据结构一致。

Step 1 自定义 servlet 容器

须要注意的是，Spring Boot 2.x 和 Sprig Boot 1.x 是不同的。

此处 Demo 咱们仅处理了 404 和 500 这两种异常。

@Configuration
public class ContainerConfig {

    /** 下面是 springboot 2.x 系列的写法 */
    @Bean
    public WebServerFactoryCustomizer<ConfigurableWebServerFactory> webServerFactoryCustomizer(){
        return factory -> {
            factory.addErrorPages(new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/error/500"));
            factory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/error/404"));
        };
    }

    /** 下面是 springboot 1.x 系列的写法 */
    /*@Bean public EmbeddedServletContainerCustomizer containerCustomizer(){ return new EmbeddedServletContainerCustomizer(){ @Override public void customize(ConfigurableEmbeddedServletContainer container) { container.addErrorPages(new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/error/500")); container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/error/404")); } }; }*/
}
复制代码

Step 2 自定义对应的请求处理类

@Controller
public class MyBasicErrorController extends BasicErrorController {

    public MyBasicErrorController() {
        super(new DefaultErrorAttributes(), new ErrorProperties());
    }

    /** * @Description: 定义500的ModelAndView * @Param: [request, response] * @return: org.springframework.web.servlet.ModelAndView * @Author: Jet.Chen * @Date: 2019-07-17 21:56 */
    @RequestMapping(produces = "text/html",value = "/500")
    public ModelAndView errorHtml500(HttpServletRequest request, HttpServletResponse response) {
        response.setStatus(getStatus(request).value());
        Map<String, Object> model = getErrorAttributes(request, isIncludeStackTrace(request, MediaType.TEXT_HTML));
        model.put("msg","自定义错误信息");
        return new ModelAndView("error/500", model);
    }


    /** * @Description: 定义500 和 404 的错误JSON信息 * @Param: [request] * @return: org.springframework.http.ResponseEntity<cn.jetchen.steecrserver.config.STCRResposeData> * STCRResposeData 为全局统一的接口数据结构 * @Author: Jet.Chen * @Date: 2019-07-17 23:13 */
    @RequestMapping(value = {"/500", "/404"})
    @ResponseBody
    public ResponseEntity<STCRResposeData> error500(HttpServletRequest request) {
        Map<String, Object> body = getErrorAttributes(request, isIncludeStackTrace(request, MediaType.TEXT_HTML));
        HttpStatus status = getStatus(request);
        Object messageTemp;
        // stcrResposeData 为返回的数据
        STCRResposeData stcrResposeData = STCRResposeData.initError(
                String.format("%d%d", 1, status.value()), 
                (messageTemp = body.get("error")) == null ? null : messageTemp.toString(),
                new HashMap<String, Object>() {{
                    put("error", body.get("error"));
                    put("message", body.get("message"));
                }});
        return new ResponseEntity<>(stcrResposeData, status);
    }


    /** * @Description: 定义404的ModelAndView * @Param: [request, response] * @return: org.springframework.web.servlet.ModelAndView * @Author: Jet.Chen * @Date: 2019-07-17 23:13 */
    @RequestMapping(produces = "text/html",value = "/404")
    public ModelAndView errorHtml400(HttpServletRequest request, HttpServletResponse response) {
        response.setStatus(getStatus(request).value());
        Map<String, Object> model = getErrorAttributes(request, isIncludeStackTrace(request, MediaType.TEXT_HTML));
        model.put("msg","自定义错误信息");
        return new ModelAndView("error/404", model);
    }
}
复制代码

小结

全局异常的处理是很是有必要的，可是此文到此的处理方式其实才完成了一半，这些会在下篇文章中介绍，主要是由于此到处理的是全局的错误，是在过滤器以外的，可是咱们但愿处理的粒度更细一点。

好比在控制器层的全局处理方式：@ControllerAdvice，从抽象概念上能够理解成它是处理那些在 Controller 方法中抛出的异常。