Spring Boot 3自定义错误页面

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,并编写动态错误信息
 

templates/error/4xx.html
templates/error/4xx.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

需要手动设置错误状态码 

boot3 如下设置

request.setAttribute(“jakarta.servlet.error.status_code”,404);

boot2设置

request.setAttribute(“javax.servlet.error.status_code”,404);

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

方案二：自定义ErrorAttributes

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

效果：

来源：SpringBoot 默认错误页面&错误页面定制

Spring Boot Spring Boot Error Spring Boot3错误页面

https://www.leftso.com/article/2409072146536218.html