SpringBoot专题学习Part17：SpringBoot自定义定制错误响应页面及JSON数据

有时候页面出现了一些错误 然后就会出现错误页面
但是SpringBoot默认的错误页面有点丑 可以自定义修改一下

用浏览器访问的时候 显示的是错误页面

用其它途径访问的时候 返回的是JSON数据

因而 分成这两部分来记录 该如何定制修改
首先 是原理

原理：

SpringBoot处理异常在ErrorMvcAutoConfiguration类中
其给容器添加了4个比较重要的类：

• 1、DefaultErrorAttributes
  可在页面通过对应的key获取信息：
  timestamp：时间戳
  status：状态码
  error：错误提示
  exception：异常对象
  message：异常消息
  errors：数据校验错误信息(JSR303)
• 2、BasicErrorController
  底层：

@Controller
@RequestMapping("${server.error.path:${error.path:/error}}")
public class BasicErrorController extends AbstractErrorController {
   
    ...(省略)
}

处理默认的/error请求

• 3、ErrorPageCustomizer
  底层：

@Value("${error.path:/error}")
private String path = "/error";

当系统出现错误之后 会来到/error请求进行处理

• 4、DefaultErrorViewResolver
  指定Springboot默认错误页面路径
  若模板引擎可解析该页面地址 则用模板引擎来解析 并返回到指定的视图地址
  若无法解析 则在静态资源文件夹下找对应的页面

内部执行流程是这样的：
首先 系统出现4xx或5xx之类的错误 然后ErrorPageCustomizer就会生效 根据内部定制的错误响应规则
然后来到/error请求 被BasicErrorController进行处理 它里面有两种方法 虽然都是处理的是/error请求
但是会根据页面是html页面还是其它页面 然后执行两种不同的方法 生成两种不同的数据
(区分方法就是浏览器的请求头中的Accept值会带有text/html 而其它客户端不会有)
然后调用DefaultErrorViewResolver解析器 拿到ModelAndView 里面包含了错误信息

默认Springboot可找到一个 error/[状态码] 页面(例：error/404.html)
若模板引擎可解析该页面地址 则用模板引擎来解析 返回ModelAndView 返回到指定的视图地址
若无法解析 则在静态资源文件夹下找对应的 error/[状态码] 页面

一、定制错误页面

1、若有模板引擎

将错误页面命名为：状态码.html
放置于模板引擎包下的error包下(默认没有 须自己创建)
例：error/404.html

当发生此状态码的错误 即跳转到该页面
错误页面还可命名为4xx或5xx 即代表以该数字开头的错误都会跳转到该页面
同时存在时 若有精确匹配的页面 则先用精确匹配的页面

然后 在前台的页面上直接获取即可
例：

<h1>status:[[${status}]]</h1>
<h2>timestamp:[[${timestamp}]]