springboot异常处理机制之自定义404、500错误提示页面

目录

  • `springboot` 自定义 `404、500` 错误页面
    • `springboot` 默认的异常处理机制
    • 使用模板引擎
      • 使用示例
        • 创建 `springboot` 项目如下
        • `application.properties` 项目配置文件
        • `404` 页面内容如下
        • `500` 页面内容如下
        • `controller` 如下
        • `404.html` 页面测试
        • `500.html` 页面测试
    • 没有使用模板引擎

springboot 自定义 404、500 错误页面

springboot 默认的异常处理机制

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

使用模板引擎

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

错误提示页面的命名规则就是:错误码.html,如 404404.html500500.html

使用示例

创建 springboot 项目如下

404、500 错误提示页面结构如下

springboot异常处理机制之自定义404、500错误提示页面_第1张图片

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>404title>
    <link rel="shortcut icon" type="image/x-icon" th:href="@{/img/favicon.ico}"/>
    <link rel="stylesheet" type="text/css" th:href="@{/css/404.css}"/>
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>500title>
    <link rel="shortcut icon" type="image/x-icon" th:href="@{/img/favicon.ico}"/>
    <link rel="stylesheet" type="text/css" th:href="@{/css/500.css}"/>
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,结果如下

springboot异常处理机制之自定义404、500错误提示页面_第2张图片

500.html 页面测试

访问已存在的接口:http://localhost:8080/toLogin,结果如下

springboot异常处理机制之自定义404、500错误提示页面_第3张图片

没有使用模板引擎

如果没有使用 thymeleaf 等模板引擎时,springboot 会到静态资源文件夹寻找 404.htm、500.html的错误提示页面,命名同上。springboot 中默认的静态资源路径有 4 个,分别是

  • classpath:/METAINF/resources/
  • classpath:/resources/
  • classpath:/static/
  • classpath:/public/

优先级顺序为:META-INF/resources > resources > static > public,以上 4 种路径创建 error 文件夹,再创建 404、500 错误提示页面如下

springboot异常处理机制之自定义404、500错误提示页面_第4张图片
不用写额外的映射器,就能直接请求到

你可能感兴趣的:(springboot,springboot)