一、SpringBoot默认的错误处理机制

1 SpringBoot默认的错误效果

1)浏览器,返回一个默认的错误页面

springboot knife4j无页面 springboot错误页面_状态码


浏览器发送请求的请求头

springboot knife4j无页面 springboot错误页面_自适应_02


2)如果是其他客户端(app),默认响应一个json数据(postman模拟)

springboot knife4j无页面 springboot错误页面_自适应_03


客户端的请求头

springboot knife4j无页面 springboot错误页面_错误页面_04


3)springboot错误处理原理:

ErrorMvcAutoConfiguration:错误处理的自动配置;它给容器中添加了以下组件。a ) DefaultErrorAttributes:帮我们在页面共享信息

springboot knife4j无页面 springboot错误页面_自适应_05


b ) BasicErrorController:处理默认/error请求(根据请求头选择具体方法)

springboot knife4j无页面 springboot错误页面_错误页面_06


springboot knife4j无页面 springboot错误页面_错误页面_07


c)ErrorPageCustomizer:

系统出现错误以后来到error请求进行处理;(web.xml注册的错误页面规则)

springboot knife4j无页面 springboot错误页面_自适应_08

d ) DefaultErrorViewResolver:默认的错误视图解析

springboot knife4j无页面 springboot错误页面_错误页面_09


springboot错误处理步骤:

a)一但系统出现4xx或者5xx之类的错误;ErrorPageCustomizer就会生效(定制错误的响应规则);就会来到/error请求;

b)error请求会被BasicErrorController处理(根据请求头进行不同处理);

c)响应页面;去哪个页面是由DefaultErrorViewResolver解析得到的;

springboot knife4j无页面 springboot错误页面_自适应_10

2 如何定制错误响应

1 ) 如何定制错误的页面:

a)、有模板引擎的情况下;error/状态码; 【将错误页面命名为 错误状态码.html 放在模板引擎文件夹里面的error文件夹下】,发生此状态码的错误就会来到 对应的页面;
我们可以使用4xx和5xx作为错误页面的文件名来匹配这种类型的所有错误,精确优先(优先寻找精确的状态码.html);

在templates下新建error目录,新建异常页面404.html,400.html,并编写动态错误信息

springboot knife4j无页面 springboot错误页面_自适应_11


浏览器访问不存在的uri,结果如下

springboot knife4j无页面 springboot错误页面_错误页面_12


页面能获取的信息;

timestamp:时间戳

status:状态码

error:错误提示

exception:异常对象

message:异常消息

errors:JSR303数据校验的错误都在这里

b)、没有模板引擎(模板引擎找不到这个错误页面),静态资源文件夹下找;
此时错误页面是静态的
不能动态获取页面的timestamp、status等信息

c)、以上都没有错误页面,就是默认来到SpringBoot默认的错误提示页面;

2)如何定制错误的json数据:

a ) 自定义异常处理&返回定制json数据;

springboot knife4j无页面 springboot错误页面_错误页面_13


缺点:不能自适应,浏览器和postman都返回json

springboot knife4j无页面 springboot错误页面_自适应_14


springboot knife4j无页面 springboot错误页面_自适应_15


b)添加转发到/error进行自适应响应效果处理

springboot knife4j无页面 springboot错误页面_状态码_16


return “forward:/error”;转发到/error请求,会被BasicErrorController(ErrorMvcAutoConfiguration组件)处理做出自适应响应自适应问题解决了,但是响应状态码默认是200

springboot knife4j无页面 springboot错误页面_状态码_17


需要手动设置错误状态码 request.setAttribute(“javax.servlet.error.status_code”,404);

springboot knife4j无页面 springboot错误页面_错误页面_18

c)将我们的定制数据携带出去(终极版);
出现错误以后,会来到/error请求,会被BasicErrorController处理,响应出去可以获取的数据是由getErrorAttributes得到的(是AbstractErrorController(ErrorController)规定的方法);
l)方案一:完全来编写一个ErrorController的实现类【或者是编写AbstractErrorController的子类】,放在容器中,这种方法比较复杂;
ll ) 页面上能用的数据,或者是json返回能用的数据都是通errorAttributes.getErrorAttributes得到;
容器中DefaultErrorAttributes.getErrorAttributes();默认进行数据处理的;
方案二:自定义ErrorAttributes

springboot knife4j无页面 springboot错误页面_状态码_19


0表示从request域中获取

1表示从session域中获取

springboot knife4j无页面 springboot错误页面_状态码_20

最终的效果:响应是自适应的,可以通过定制ErrorAttributes改变需要返回的内容,

springboot knife4j无页面 springboot错误页面_自适应_21


springboot knife4j无页面 springboot错误页面_自适应_22


springboot knife4j无页面 springboot错误页面_自适应_23