快捷導(dǎo)航

SpringBoot異常錯誤頁面實現(xiàn)方法介紹

更新時間：2022年09月13日 09:47:47 作者：流楚丶格念

在項目訪問的時候我們經(jīng)常會發(fā)生錯誤或者頁面找不到，比如：資源找不到404，服務(wù)器500錯誤，默認情況下springboot的處理機制都是去跳轉(zhuǎn)內(nèi)部的錯誤地址：/error 和與之對應(yīng)的一個錯誤頁面

導(dǎo)言

默認情況下，SpringBoot 項目錯誤頁面如下：

直接這樣太丑了，我們實際上線項目時，如果給用戶顯示這個頁面就不是很友好，用戶直接不用了。

所以當系統(tǒng)出現(xiàn)異常時應(yīng)該給用戶更加友好的錯誤頁面，下面我們來看具體是如何實現(xiàn)的。

實現(xiàn)步驟

加入thymeleaf依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

在templates/下新建error文件夾

在error中新建：狀態(tài).html的頁面。例如當出現(xiàn)500時顯示的頁面為500.html，當出現(xiàn)404時顯示的頁面為404.html，

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>404</title>
</head>
<body>
    <h1>
        404!沒有這個請求，請檢查！
    </h1>
</body>
</html>

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>500</title>
</head>
<body>
    <h1>
        500！您的代碼出現(xiàn)了內(nèi)部錯誤，請檢查！
    </h1>
</body>
</html>

然后創(chuàng)建controller

@Controller
public class ErrorController {
    @RequestMapping("/test")
    public String testError(){
        System.out.println(5/0);
        // return "500";
        return "500.html";
    }
}

我們知道，在運行上面代碼的時候發(fā)生算術(shù)異常。錯誤碼為500。

測試如下：

使用X進行模糊匹配

當出現(xiàn)5開頭狀態(tài)碼的錯誤時，顯示頁面可以命名為5xx.html
如果500.html和5xx.html同時存在，則會精確匹配相應(yīng)頁面

我們把剛才的500.html改為5xx.html，也是可以的

因為發(fā)生了5開頭的異常，會走5xx.html，測試如下：

統(tǒng)一錯誤頁面顯示

在templates下新建error.html。如果項目中不存在具體狀態(tài)碼的頁面或沒有使用x成功匹配的頁面時，顯示error.html作為錯誤顯示頁面。

比如我們在error下沒有設(shè)置4xx相關(guān)的錯誤頁面，當發(fā)生狀態(tài)碼為4xx的錯誤時，找不到相關(guān)的錯誤處理頁面，這時會走一個統(tǒng)一的錯誤處理頁面。一般會在templates下創(chuàng)建error.html，作為統(tǒng)一的錯誤處理頁面。

在templates下創(chuàng)建error.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>error</title>
</head>
<body>
    <h1>
        error?。?！
    </h1>
</body>
</html>

當發(fā)生404錯誤時，會自動走error.html