使用Web应用时,在请求处理过程中发生错误是非常常见的情况.SpringBoot为我们提供一个默认的映射:/error
,当处理中抛出异常之后,会转到该请求中处理,并且该请求有一个全局的错误页面来展示异常内容.比如现在启动my-spring-boot项目,项目启动完成之后,在浏览器中随便输入一个访问地址,由于地址不存在,SpringBoot会跳转到错误页面,如图所示.
虽然Spring Boot为我们提供了默认的错误页面映射,但是在实际应用中,上图所示的错误页面对用户来说并不友好,我们需要自己来实现异常提示,接下来将演示自己实现错误的提示页面.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>404页面</title>
</head>
<body>
<div class="text" style="text-align: center;">
我累了,让我休息一会!
</div>
</body>
</html>
其次,新建ErrorPageConfig
配置类,具体代码如下:
@Configuration
public class ErrorPageConfig implements ErrorPageRegistrar {
@Override
public void registerErrorPages(ErrorPageRegistry registry) {
ErrorPage error404Page = new ErrorPage(HttpStatus.NOT_FOUND, "/404.html");
registry.addErrorPages(error404Page);
}
}
测试
重启项目,在浏览器上输入错误的链接,就会看到访问到了我们自定义的错误页面。
值得注意的是,配置文件可以不写,我们可以将集中特定的错误页面如404、505等错误码页面自己写好放在特定的目录下,springBoot会去特定目录下根据错误码找页面,如果没有,springboot才会给出默认的错误页面。
在配置了freemarker的环境下,如我们在application.yml 中做了如下配置
freemarker:
request-context-attribute: request
template-loader-path: classpath:/templates/
则我只需要在templates目录下新建error目录,然后在error目录下放置404.html、505.html等错误码为文件名的html页面,即可访问
如果templates/error 目录下没有自定义的错误页面:在 static/error 目录下寻找 4xx 或 5xx 页面,如果找到则使用
当然,你要先配置SpringMVC静态资源处理
如果 templates/error目录和 static/error目录都没有自定义的 4xx 或 5xx 页面 ,则使用 SpringBoot默认的错误页面