springboot全局异常处理_全局异常处理教程

全局异常处理教程

一.SpringBoot全局异常处理方式

正常的Web应用开发时,需要考虑到应用运行发生异常时或出现错误时如何来被处理,例如捕获必要的异常信息,记录日志方便日后排错,友好的用户响应输出等等.而应用程序发生错误,有可能是应用自身的问题,也有可能是客户端操作的问题.在我们的项目中全局异常处理非常重要.

大概有三种异常情况：
1️⃣.在进入Controller之前,譬如请求一个不存在的地址404错误;

2️⃣.在执行@RequestMapping时,进入逻辑处理阶段前,譬如传的参数类型错误;

3️⃣.以上都正常时,在controller里执行逻辑代码时出的异常,比如出现NullPointerException.

二.Spring Boot默认的错误处理机制。

1. 默认错误处理机制

默认情况下，Spring Boot为两种情况提供了不同的响应方式。
一种是浏览器客户端访问应用发生错误时，一般情况下浏览器默认发送的请求头中Accept: text/html（当然你更改了就另当别论了），所以Spring Boot默认会响应一个html文档内容，称作“Whitelabel Error Page”。

2. 第三方工具请求接口时

另一种是机器客户端访问应用发送错误时，Spring Boot会响应Json格式内容。这种情况更常见于利用第三方的Http工具请求接口时。

如果看过源码，会发现两种方式输出用到的内容项是一样的，只不过第一种方式用html格式显示，第二种方式使用了Json格式。

Spring Boot提供这个错误处理机制靠自动配置的BasicErrorController类。如果好奇Spring Boot是如何实现这种机制的。可以参看下BasicErrorController源码以及SpringMVC请求映射匹配规则。

三.自定义多种错误页面

上述的默认错误处理机制是一种通用的做法，你可能更期望细化一些处理，对于某些错误你可能想特殊对待。

Spring Boot提供了一种方式，笔者认为这种方式是“容器级别”的操作。
如下：

@Configuration
public class ContainerConfig {
    @Bean
    public EmbeddedServletContainerCustomizer containerCustomizer(){
        return new MyCustomizer();
    }
 
    private static class MyCustomizer implements EmbeddedServletContainerCustomizer {
        @Override
        public void customize(ConfigurableEmbeddedServletContainer container) {
            container.addErrorPages(new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/500"));
        }
    }
}

笔者新增了一个配置类，里面定义了一个bean，主要目的在于针对响应码为500的错误，采用笔者自定义的方式处理。如下：