Springboot實(shí)現(xiàn)自定義錯誤頁面的方法(錯誤處理機(jī)制)
一般我們在做項(xiàng)目的時候,錯誤機(jī)制是必備的常識,基本每個項(xiàng)目都會做錯誤處理,不可能項(xiàng)目一報錯直接跳到原始報錯頁面,本篇博客主要針對springboot默認(rèn)的處理機(jī)制,以及自定義錯誤頁面處理進(jìn)行講解,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧!
默認(rèn)效果示例
springboot他是有自己默認(rèn)的處理機(jī)制的。在你剛創(chuàng)建一個springboot項(xiàng)目去訪問一個沒有的路徑會發(fā)現(xiàn)他是會彈出來這樣的信息。
而我們用postman直接接口訪問,會發(fā)現(xiàn)他返回的不再是頁面。默認(rèn)響應(yīng)一個json數(shù)據(jù)
這時候該有人在想,springboot他是如何識別我們是否是頁面訪問的呢?
效果示例原因
springboot默認(rèn)錯誤處理機(jī)制他是根據(jù)Headers當(dāng)中的Accept來判斷的,這個參數(shù)無論是postman訪問還是頁面訪問都會傳入。
頁面訪問的時候他傳入的是test/html
而postman是這個
錯誤機(jī)制原理
原因我們大概了解了,接下來通過翻看源碼我們簡單的來理解一下他的原理。
簡單回顧springboot原理
springboot之所以開箱即用,是因?yàn)楹芏嗫蚣芩呀?jīng)幫我們配置好了,他內(nèi)部有很多AutoConfiguration,其中ErrorMvcAutoConfiguration類就是錯誤機(jī)制配置。
存放于這個jar包下
springboo 2.4版本當(dāng)中ErrorMvcAutoConfiguration存放于這個路徑
springboot 1.5版本ErrorMvcAutoConfiguration存放于這個路徑
當(dāng)然他只是版本之間類存放位置發(fā)生一些改動,但是源碼區(qū)別不是很大。
springboot內(nèi)部使用到配置的地方,都是去容器當(dāng)中取的,容器的作用就是將這些配置實(shí)例化過程放到了啟動,我們在用的時候直接從容器當(dāng)中取而無需創(chuàng)建,這也就是圍繞容器開發(fā)的原因,在使用springboot的時候應(yīng)該也都會發(fā)現(xiàn),我們想要修改springboot的一些默認(rèn)配置都會想方設(shè)法把他放到容器當(dāng)中,他才會生效。
在源碼當(dāng)中會發(fā)現(xiàn)存在大量@ConditionalOnMissingBean,這個就是假如我們項(xiàng)目當(dāng)中配置了該項(xiàng)配置,springboot就不會使用他的默認(rèn)配置了,就直接用我們配置好的。
ErrorMvcAutoConfiguration配置
ErrorMvcAutoConfiguration給容器中添加了以下組件:
1、DefaultErrorAttributes
頁面當(dāng)中錯誤信息,以及訪問時間等等,都是在DefaultErrorAttributes當(dāng)中的這兩個方法當(dāng)中獲取的。
@Override public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) { Map<String, Object> errorAttributes = getErrorAttributes(webRequest, options.isIncluded(Include.STACK_TRACE)); if (Boolean.TRUE.equals(this.includeException)) { options = options.including(Include.EXCEPTION); } if (!options.isIncluded(Include.EXCEPTION)) { errorAttributes.remove("exception"); } if (!options.isIncluded(Include.STACK_TRACE)) { errorAttributes.remove("trace"); } if (!options.isIncluded(Include.MESSAGE) && errorAttributes.get("message") != null) { errorAttributes.put("message", ""); } if (!options.isIncluded(Include.BINDING_ERRORS)) { errorAttributes.remove("errors"); } return errorAttributes; } @Override @Deprecated public Map<String, Object> getErrorAttributes(WebRequest webRequest, boolean includeStackTrace) { Map<String, Object> errorAttributes = new LinkedHashMap<>(); errorAttributes.put("timestamp", new Date()); addStatus(errorAttributes, webRequest); addErrorDetails(errorAttributes, webRequest, includeStackTrace); addPath(errorAttributes, webRequest); return errorAttributes; }
2、BasicErrorController
處理默認(rèn)/error請求
也正是BasicErrorController這兩個方法,來判斷是返回錯誤頁面還是返回json數(shù)據(jù)
@RequestMapping(produces = MediaType.TEXT_HTML_VALUE) public ModelAndView errorHtml(HttpServletRequest request, HttpServletResponse response) { HttpStatus status = getStatus(request); Map<String, Object> model = Collections .unmodifiableMap(getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.TEXT_HTML))); response.setStatus(status.value()); ModelAndView modelAndView = resolveErrorView(request, response, status, model); return (modelAndView != null) ? modelAndView : new ModelAndView("error", model); } @RequestMapping public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) { HttpStatus status = getStatus(request); if (status == HttpStatus.NO_CONTENT) { return new ResponseEntity<>(status); } Map<String, Object> body = getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.ALL)); return new ResponseEntity<>(body, status); }
3、ErrorPageCustomizer
系統(tǒng)出現(xiàn)錯誤以后來到error請求進(jìn)行處理;(就相當(dāng)于是web.xml注冊的錯誤頁 面規(guī)則)
加粗樣式
4、DefaultErrorViewResolver
DefaultErrorViewResolverConfiguration內(nèi)部類
在這里我們可以看出他將DefaultErrorViewResolver注入到了容器當(dāng)中
DefaultErrorViewResolver這個對象當(dāng)中有兩個方法,來完成了根據(jù)狀態(tài)跳轉(zhuǎn)頁面。
@Override public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) { //獲取錯誤狀態(tài)碼,這里可以看出他將狀態(tài)碼傳入了resolve方法 ModelAndView modelAndView = resolve(String.valueOf(status), model); if (modelAndView == null && SERIES_VIEWS.containsKey(status.series())) { modelAndView = resolve(SERIES_VIEWS.get(status.series()), model); } return modelAndView; } private ModelAndView resolve(String viewName, Map<String, Object> model) { //從這里可以得知,當(dāng)我們報404錯誤的時候,他會去error文件夾找404的頁面,如果500就找500的頁面。 String errorViewName = "error/" + viewName; //模板引擎可以解析這個頁面地址就用模板引擎解析 TemplateAvailabilityProvider provider = this.templateAvailabilityProviders .getProvider(errorViewName, this.applicationContext); //模板引擎可用的情況下返回到errorViewName指定的視圖地址 if (provider != null) { return new ModelAndView(errorViewName, model); } //模板引擎不可用,就在靜態(tài)資源文件夾下找errorViewName對應(yīng)的頁面 error/404.html return resolveResource(errorViewName, model); }
組件執(zhí)行步驟
一但系統(tǒng)出現(xiàn)4xx或者5xx之類的錯誤;ErrorPageCustomizer就會生效(定制錯誤的響應(yīng)規(guī)則);就會來到/error 請求;就會被BasicErrorController處理;去哪個頁面是由DefaultErrorViewResolver解析得到的;
代碼示例
這里我選擇直接上代碼,方便大家更快的上手。
1、導(dǎo)入依賴
這里我引用了thymeleaf模板,springboot內(nèi)部為我們配置好了頁面跳轉(zhuǎn)功能。
這是本人寫的一篇關(guān)于thymeleaf的博客,沒用過的或者不是很了解的可以學(xué)習(xí)一下!
thymeleaf學(xué)習(xí): https://blog.csdn.net/weixin_43888891/article/details/111350061.
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency> </dependencies>
2、自定義異常
作用:面對一些因?yàn)闆]找到數(shù)據(jù)而報空指針的錯誤,我們可以采取手動拋異常。
package com.gzl.cn; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.ResponseStatus; @ResponseStatus(HttpStatus.NOT_FOUND) public class NotFoundException extends RuntimeException { public NotFoundException() { } public NotFoundException(String message) { super(message); } public NotFoundException(String message, Throwable cause) { super(message, cause); } }
3、定義異常攔截
package com.gzl.cn.handler; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.core.annotation.AnnotationUtils; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.servlet.ModelAndView; import javax.servlet.http.HttpServletRequest; @ControllerAdvice public class ControllerExceptionHandler { private final Logger logger = LoggerFactory.getLogger(this.getClass()); @ExceptionHandler(Exception.class) public ModelAndView exceptionHander(HttpServletRequest request, Exception e) throws Exception { logger.error("Requst URL : {},Exception : {}", request.getRequestURL(),e); //假如是自定義的異常,就讓他進(jìn)入404,其他的一概都進(jìn)入error頁面 if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) { throw e; } ModelAndView mv = new ModelAndView(); mv.addObject("url",request.getRequestURL()); mv.addObject("exception", e); mv.setViewName("error/error"); return mv; } }
4、創(chuàng)建測試接口
package com.gzl.cn.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; import com.gzl.cn.NotFoundException; @Controller public class HelloController { //這個請求我們拋出我們定義的錯誤,然后被攔截到直接跳到404,這個一般當(dāng)有一些數(shù)據(jù)查不到的時候手動拋出 @GetMapping("/test") public String test(Model model){ String a = null; if(a == null) { throw new NotFoundException(); } System.out.println(a.toString()); return "success"; } //這個請求由于a為null直接進(jìn)500頁面 @GetMapping("/test2") public String test2(Model model){ String a = null; System.out.println(a.toString()); return "success"; } }
5、創(chuàng)建404頁面
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Insert title here</title> </head> <body> <h2>404</h2> <p>對不起,你訪問的資源不存在</p> </body> </html>
6、創(chuàng)建error頁面
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Insert title here</title> </head> <body> <h2>錯誤</h2> <p>對不起,服務(wù)異常,請聯(lián)系管理員</p> <!--這段代碼在頁面不會展現(xiàn),只會出現(xiàn)在控制臺,假如線上報錯可以看控制臺快速鎖定錯誤原因--> <div> <div th:utext="'<!--'" th:remove="tag"></div> <div th:utext="'Failed Request URL : ' + ${url}" th:remove="tag"></div> <div th:utext="'Exception message : ' + ${exception.message}" th:remove="tag"></div> <ul th:remove="tag"> <li th:each="st : ${exception.stackTrace}" th:remove="tag"><span th:utext="${st}" th:remove="tag"></span></li> </ul> <div th:utext="'-->'" th:remove="tag"></div> </div> </body> </html>
7、項(xiàng)目結(jié)構(gòu)
8、運(yùn)行效果
http://localhost:8080/test2
這時候可以觀察到,那段代碼在此處生效了,這樣做的好處就是客戶看不到,看到了反而也不美觀,所以采取這種方式。
訪問一個不存在的頁面
訪問http://localhost:8080/test
這個時候會發(fā)現(xiàn)他跳到了404頁面
到此這篇關(guān)于Springboot實(shí)現(xiàn)自定義錯誤頁面的方法(錯誤處理機(jī)制)的文章就介紹到這了,更多相關(guān)Springboot自定義錯誤頁面內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
利用Java實(shí)現(xiàn)動態(tài)加載數(shù)據(jù)庫
這篇文章主要為大家詳細(xì)介紹了一個java小案例,即動態(tài)加載數(shù)據(jù)庫信息,文中的示例代碼簡潔易懂,具有一定的學(xué)習(xí)價值,感興趣的小伙伴可以了解一下2023-10-10java實(shí)現(xiàn)301跳轉(zhuǎn)和重定向的方法
301跳轉(zhuǎn)和重定向是做項(xiàng)目的時候經(jīng)常需要用到的,本文給大家分享的是在java中301跳轉(zhuǎn)和重定向的方法,需要的小伙伴參考下吧。2015-03-03mybatis實(shí)體類字段大小寫及字段獲取不到值問題
這篇文章主要介紹了mybatis實(shí)體類字段大小寫及字段獲取不到值問題,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-12-12簡單說明Java的Struts框架中merge標(biāo)簽的使用方法
這篇文章主要簡單介紹了Java的Struts框架中merge標(biāo)簽的使用方法,Struts是Java的SSH三大web開發(fā)框架之一,需要的朋友可以參考下2015-12-12