springboot 自定義404、500錯誤提示頁面的實現(xiàn)

更新時間：2021年11月28日 11:48:41 作者：桐花思雨

springboot 默認已經(jīng)提供了一套處理異常的機制。在 springboot 中提供了一個名為 BasicErrorController 的類來處理 /error 請求，然后跳轉到默認顯示異常的頁面來展示異常信息，本文就詳細的介紹一下，感興趣的可以了解一下

springboot 默認的異常處理機制

springboot 默認已經(jīng)提供了一套處理異常的機制。一旦程序中出現(xiàn)了異常 springboot 會向 /error 的 url 發(fā)送請求。在 springboot 中提供了一個名為 BasicErrorController 的類來處理 /error 請求，然后跳轉到默認顯示異常的頁面來展示異常信息

使用模板引擎

在使用 thymeleaf 等模板引擎時，springboot 會自動到 src/main/resources/templates/error/，文件夾下尋找 404.html、500.html 的錯誤提示頁面

錯誤提示頁面的命名規(guī)則就是：錯誤碼.html，如 404 是 404.html，500 是 500.html

使用示例

創(chuàng)建 springboot 項目如下

404、500 錯誤提示頁面結構如下

在這里插入圖片描述

application.properties 項目配置文件

server.port=8080

#它的默認值就是classpath:/templates/，源碼在ThymeleafProperties類中
spring.mvc.view.prefix=classpath:/templates/
#它的默認值就是.html，源碼在ThymeleafProperties類中
spring.mvc.view.suffix=.html
spring.thymeleaf.cache=false

404 頁面內容如下

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>404</title>
    <link rel="shortcut icon" type="image/x-icon" th:href="@{/img/favicon.ico}" rel="external nofollow"  rel="external nofollow" />
    <link rel="stylesheet" type="text/css" th:href="@{/css/404.css}" rel="external nofollow" />
</head>
<body>
	<div id="banner" style="height: 600px;width: 600px;margin-left: 370px"></div>
</body>
</html>

500 頁面內容如下

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>500</title>
    <link rel="shortcut icon" type="image/x-icon" th:href="@{/img/favicon.ico}" rel="external nofollow"  rel="external nofollow" />
    <link rel="stylesheet" type="text/css" th:href="@{/css/500.css}" rel="external nofollow" />
</head>
<body>
    <div id="banner" style="height: 600px;width: 600px;margin-left: 370px"></div>
</body>
</html>

controller 如下

@Controller
public class PageController {

    // 跳轉到登錄頁
    @GetMapping(path = "/toLogin")
    public String toLogin() {
        int code = 1/0;
        return "login";
    }
}

404.html 頁面測試

訪問不存在的接口：http://localhost:8080/aaaa，結果如下

在這里插入圖片描述