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

1 SpringBoot默认的错误效果

1)浏览器,返回一个默认的错误页面
在这里插入图片描述
浏览器发送请求的请求头
在这里插入图片描述
2)如果是其他客户端(app),默认响应一个json数据(postman模拟)
在这里插入图片描述
客户端的请求头
在这里插入图片描述
3)springboot错误处理原理:
ErrorMvcAutoConfiguration:错误处理的自动配置;它给容器中添加了以下组件。

a ) DefaultErrorAttributes:帮我们在页面共享信息
在这里插入图片描述
b ) BasicErrorController:处理默认/error请求(根据请求头选择具体方法)
在这里插入图片描述
在这里插入图片描述
c)ErrorPageCustomizer:
系统出现错误以后来到error请求进行处理;(web.xml注册的错误页面规则)
在这里插入图片描述

d ) DefaultErrorViewResolver:默认的错误视图解析
在这里插入图片描述
springboot错误处理步骤:
a)一但系统出现4xx或者5xx之类的错误;ErrorPageCustomizer就会生效(定制错误的响应规则);就会来到/error请求;
b)error请求会被BasicErrorController处理(根据请求头进行不同处理);
c)响应页面;去哪个页面是由DefaultErrorViewResolver解析得到的;
在这里插入图片描述

2 如何定制错误响应

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

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

在templates下新建error目录,新建异常页面404.html,400.html,并编写动态错误信息
在这里插入图片描述
浏览器访问不存在的uri,结果如下
在这里插入图片描述
页面能获取的信息;
timestamp:时间戳
status:状态码
error:错误提示
exception:异常对象
message:异常消息
errors:JSR303数据校验的错误都在这里

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

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

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

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

在这里插入图片描述
缺点:不能自适应,浏览器和postman都返回json
在这里插入图片描述
在这里插入图片描述
b)添加转发到/error进行自适应响应效果处理

在这里插入图片描述
return “forward:/error”;转发到/error请求,会被BasicErrorController(ErrorMvcAutoConfiguration组件)处理做出自适应响应

自适应问题解决了,但是响应状态码默认是200
在这里插入图片描述
需要手动设置错误状态码 request.setAttribute(“javax.servlet.error.status_code”,404);

在这里插入图片描述

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

在这里插入图片描述
0表示从request域中获取
1表示从session域中获取
在这里插入图片描述

最终的效果:响应是自适应的,可以通过定制ErrorAttributes改变需要返回的内容,
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐