当系统出现异常时候,或404,或500,默认返回的错误页面通常非常简陋,用户也看不懂,这时候我们想通过一些手段,提示用户访问的资源不存在,或者请稍后再试。
同时有个统一的异常处理机制可以提高我们系统的健壮性,微服务化之后系统之间的调用结果会影响到整个服务的可用性。如果被调用方出现异常没有返回统一的异常处理结果,很容易会调用方疑惑,然后滚大整个异常,这时候你看到整个服务之间都在报错,这不是我们想看到的~
那么基于springboot,我们有多少种异常处理方式呢?
静态处理
这是一种比较偷懒也是最简单的处理方式,直接放置一个静态的页面。我们静态看到有些项目直接就返回一个大大的404图片作为异常的处理显示,其实就是这里说到的静态处理方式。
我们来看下错误页面的存放位置:
可以看到,我是存放在了static目录的error文件夹下,新建了一个404.html用于处理404错误。既然是静态页面,那么就不能使用动态渲染,所以通常静态的异常页面都会写得比较死,要么就直接就是一个404图片。
静态页面中如果写了中文,这是显示的内容容易乱码,我们只需在配置文件application.yml中添加以下encoding代码:
spring.http.encoding.force=true
我们先来访问一个不存在的路径http://localhost:9009/test5,看下效果:
-
未处理前:
-
静态处理后:
我们的404.html页面起作用啦,如果不存在404.html,或者出现401异常的时候,系统就会自动匹配到4xx.html页面,所以这个4xx相当于可以通配处理所有的客户端错误:4xx。类似的500.html和5xx.html处理服务器错误:5xx。
好,上面的静态处理异常我们已经可以懂了,那么你知道它的原理吗?
其实在springboot项目启动的时候,会去加载异常处理的默认配置ErrorMvcAutoConfiguration,而在ErrorMvcAutoConfiguration里面,有个默认的异常处理控制器BasicErrorController(org.springframework.boot.autoconfigure.web.servlet.error.BasicErrorController),我们在这构造方法中打个端点,可以看到异常处理器errorViewResolvers的resourceProperties中就默认初始化好了所有可以存放静态异常页面的地方。
然后你再把端点打在ModelAndView errorHtml(HttpServletRequest request, HttpServletResponse response)方法上,你就会清晰看到,其实springboot项目会循环搜索这4个位置的文件夹,看时候有404.html页面,如果有就直接返回,没有就返回异常的默认处理页面。
总结一下:静态处理的错误页面可以存放4个位置,分别按先后顺序搜索
-
/META-INF/resources/error/404.html -> /resources/error/404.html
-
-> /static/error/404.html -> /public/error/404.html
当找不到精确匹配404.html的时候,就会找通配的4xx.html。
ok,静态处理就先讲到这里~
动态处理
刚才我们说了一种静态处理异常的方式,但是缺点很明显,不能在静态页面中动态渲染数据啊!这无疑是比较致命的,有什么办法让页面能动态处理呢?
这里给大家介绍4种方式
-
直接在templates下写error页面,如果freemaker的error.ftl
-
重写ErrorController,覆盖BasicErrorController
-
继承ErrorPageRegistrar,重写registerErrorPages方法
-
@ControllerAdvice+@ExceptionHandler组合