SpringBoot2.3定制错误页面的方法示例
一.问题背景
后台：SpringBoot2.3.1（官方2.3版本修改了很多，抛弃了很多以前能用的方法）
前端：Layui（前端用哪个框架问题不大）
技术：SpringBoot+Thymeleaf+Layui
情况：我想将Layui提供好的错误页面作为SpringBoot默认的错误页面，而且Layui提供的错误页面位置并不是放在/静态资源文件夹/error，而是在如下：
二.SpringBoot的错误页面机制
错误页面机制的原理详情可以看Day41——错误处理原理&定制错误页面以及Day42——定制错误数据。
首先要知道SpringBoot的错误页面机制原理自动配置是由ErrorMvcAutoConfiguration配置的。所以定制错误页面的解决方案都可以参考ErrorMvcAutoConfiguration类以及参考他人博客。
这里只做简单的回顾，如下：
三.定制错误页面
首先我项目里面在application.properties配置了静态资源路径为classpath:/templates/layuimini/，如下：
#自定义静态资源路径 spring.resources.static-locations=classpath:/templates/layuimini/
大家根据需要自行调整自己项目里面的静态资源路径，后面的定制错误页面的路径会根据这个配置好的路径去寻找，或者拼串。
3.1方案一（最简单的，但是不推荐）
3.1.1步骤
最简单是在静态资源文件夹下面创建一个error文件夹，在里面放置自己的错误页面，如下：
不推荐的原因是，我当前的目录结构是所有的页面都是放在/templates/layuimini/page/文件夹下面的，如果按照上面做法，会破坏我的目录结构，后期维护很困难。
3.1.2原理
在BasicErrorController中，封装视图的时候，当前项目如果有模板引擎，会先用模板引擎解析，找不到再去静态资源文件夹寻找视图（视图名是error/状态码.html，这是指error文件夹下的状态码.html文件，这是由私有方法实现的，所以外部无法修改）。因此上面的步骤就是SpringBoot先去templates文件夹下找，找不到，再去/templates/layuimini/这个静态资源文件夹找（前提是你设置了静态资源文件夹；否则默认按SpringBoot的默认静态资源文件夹找，比如resources、public、static、resource）
3.2方案二（不能实现自适应定制错误页面，不推荐）
3.2.1步骤
首先放置好自定义的错误页面，是在/templates/layuimini/page/error/，如下：
然后再创建一个MyErrorPageConfig类，最最最关键的是newErrorPage()中第二个入参，如果是加了.html，那么就会直接找页面，如果没有加，那么将它当作请求去找controller，如下：
@Configuration
publicclassMyErrorPageConfig{
@Bean
publicWebServerFactoryCustomizerwebServerFactoryCustomizer(){
returnnewWebServerFactoryCustomizer(){
@Override
publicvoidcustomize(ConfigurableWebServerFactoryfactory){
ErrorPageerrorPage1=newErrorPage(HttpStatus.NOT_FOUND,"/page/error/4xx.html");
ErrorPageerrorPage2=newErrorPage(HttpStatus.NOT_FOUND,"/page/error/5xx.html");
factory.addErrorPages(errorPage1,errorPage2);
}
};
}
}
3.2.2原理
详情可以参考Day46——SpringBoot2.x版本的嵌入式Servlet容器自动配置原理以及Day47——嵌入式Servlet容器启动原理
首先要知道SpringBoot2.x版本的嵌入式Servlet容器是由ServletWebServerFactoryAutoConfiguration类配置的。一切的配置信息以及解决方案都可以参考这个类。
这里只做简单解释，如下：
这样它就会执行上面步骤中的customize()方法中的方法
3.3方案三（实现自适应）
自适应就是根据发送的/error请求是浏览器还是客户端，使用不同的controller方法进行处理，并返回不同类型的数据
3.3.1步骤
创建一个实现了ErrorController接口的MyBasicErrorController类，如下：
/**
*定制ErrorController，目的是能使SpringBoot找到自己定制的错误页面
*大部分的代码BasicController一致，关键点是修改错误页面的路径
*/
@Controller
@RequestMapping(value="/error")
publicclassMyBasicErrorControllerimplementsErrorController{
@RequestMapping(produces={"text/html"})//返回给浏览器
publicStringhandlerError(HttpServletRequestrequest,Modelmodel){
WebRequestwebRequest=newServletWebRequest(request);//对request进行包装，目的是能操作更多的方法
HttpStatusstatus=this.getStatus(request);//获取status
Stringpath=(String)webRequest.getAttribute("javax.servlet.error.request_uri",0);
Stringmessage=(String)webRequest.getAttribute("javax.servlet.error.message",0);
if(message.equals("")){
message="NoAvailableMessage";
}
//携带错误数据信息
model.addAttribute("timestamp",newDate());
model.addAttribute("statusCode",status.value());
model.addAttribute("error",status.getReasonPhrase());
model.addAttribute("message",message);
model.addAttribute("path",path);
inti=status.value()/100;//判断是4xx还是5xx错误
if(i==4){
return"layuimini/page/error/4xx";//使用自己定制的错误页面
}elseif(i==5){
return"layuimini/page/error/5xx";//使用自己定制的错误页面
}
returnnull;
}
@RequestMapping//返回给客户端
publicResponseEntity>error(HttpServletRequestrequest){
WebRequestwebRequest=newServletWebRequest(request);//对request进行包装，目的是能操作更多的方法
HttpStatusstatus=this.getStatus(request);//获取status
Mapmap=newHashMap<>();
if(status==HttpStatus.NO_CONTENT){
returnnewResponseEntity(status);
}else{
Stringpath=(String)webRequest.getAttribute("javax.servlet.error.request_uri",0);
Stringmessage=(String)webRequest.getAttribute("javax.servlet.error.message",0);
map.put("timestamp",newDate());
map.put("statusCode",status.value());
map.put("error",status.getReasonPhrase());
map.put("message",message);
map.put("path",path);
returnnewResponseEntity(map,status);
}
}
protectedHttpStatusgetStatus(HttpServletRequestrequest){
IntegerstatusCode=(Integer)request.getAttribute("javax.servlet.error.status_code");
if(statusCode==null){
returnHttpStatus.INTERNAL_SERVER_ERROR;
}else{
try{
returnHttpStatus.valueOf(statusCode);
}catch(Exceptionvar4){
returnHttpStatus.INTERNAL_SERVER_ERROR;
}
}
}
@Override
publicStringgetErrorPath(){
return"null";
}
}
3.3.2原理
SpringBoot的错误页面机制的自适应，是由BasicErrorController实现的，而这个BasicErrorController只有在容器中没有ErrorController的情况下，才会被注册进容器，因此我们创建一个实现了ErrorController接口的类，这个BasicErrorController就失效，然后我们仿照BasicErrorController里面的方法来实现自己的controller就可以了。如下：
@Bean
@ConditionalOnMissingBean(
value={ErrorController.class},//没有ErrorController才会去注册BasicErrorController
search=SearchStrategy.CURRENT
)
publicBasicErrorControllerbasicErrorController(ErrorAttributeserrorAttributes,ObjectProvidererrorViewResolvers){
returnnewBasicErrorController(errorAttributes,this.serverProperties.getError(),(List)errorViewResolvers.orderedStream().collect(Collectors.toList()));
}
上面实现步骤中的一些错误数据是参照DefaultErrorAttributes中的方法实现的
到此这篇关于SpringBoot2.3定制错误页面的方法示例的文章就介绍到这了,更多相关SpringBoot2.3定制错误页面内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票！
声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。