springboot 自定义404、500错误提示页面的实现

160 阅读 0 评论 106 点赞

我是靠谱客的博主健忘机器猫，最近开发中收集的这篇文章主要介绍springboot 自定义404、500错误提示页面的实现，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

springboot 默认的异常处理机制

springboot 默认已经提供了一套处理异常的机制。一旦程序中出现了异常 springboot 会向 /error 的 url 发送请求。在 springboot 中提供了一个名为 BasicErrorController 的类来处理 /error 请求，然后跳转到默认显示异常的页面来展示异常信息

使用模板引擎

在使用 thymeleaf 等模板引擎时，springboot 会自动到 src/main/resources/templates/error/，文件夹下寻找 404.html、500.html 的错误提示页面

错误提示页面的命名规则就是：错误码.html，如 404 是 404.html，500 是 500.html

使用示例

创建 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，结果如下

在这里插入图片描述