thymeleaf 使用页面报错_SpringBoot 利用thymeleaf自定义错误页面

时间: 2023-10-13 13:21:43 浏览: 138

SpringBoot自定义错误页面，SpringBoot 404、500错误提示页面

在Spring Boot应用中，我们经常会遇到各种错误情况，如HTTP状态码为404（未找到）或500（服务器内部错误）。默认情况下，Spring Boot会提供一个简单的错误页面，但这并不符合很多项目的需求，因为它们可能需要更加定制化的错误处理机制来提升用户体验。本文将详细介绍如何在Spring Boot中自定义错误页面，以及处理404和500这两种常见错误。让我们了解Spring Boot默认的错误处理机制。Spring Boot通过`ErrorController`接口和`ErrorAttributes`类来处理错误页面。当一个请求引发异常时，Spring Boot会自动捕获并渲染错误页面。默认的错误页面通常包含错误代码、简短的错误信息以及堆栈跟踪。然而，这个页面并不美观，且不包含具体的应用上下文信息。要自定义错误页面，你需要创建一个名为`error`的HTML文件，放置在`src/main/resources/templates`目录下。这个页面将作为所有HTTP错误状态码的通用错误页面。例如，你可以设计一个包含错误代码、详细信息和用户友好提示的页面。对于特定的错误状态码，如404和500，你可以在`error`目录下创建对应的HTML文件，如`404.html`和`500.html`。这样，当出现这些错误时，Spring Boot将优先使用这些特定的错误页面。除了静态HTML页面，你还可以通过编程方式处理错误。创建一个实现`ErrorController`接口的类，并重写`getErrorPath()`和`error()`方法。`getErrorPath()`返回错误页面的路径，而`error()`方法则负责处理错误并返回视图名称或者直接构建`ModelAndView`对象。 ```java @Controller public class CustomErrorController implements ErrorController { private static final String ERROR_PATH = "/error"; @Override public String getErrorPath() { return ERROR_PATH; } @RequestMapping(value = ERROR_PATH) public ModelAndView handleError(HttpServletRequest request) { Object status = request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE); if (status != null) { Integer statusCode = Integer.valueOf(status.toString()); ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("errorCode", statusCode); modelAndView.addObject("exception", request.getAttribute(RequestDispatcher.ERROR_EXCEPTION)); if (statusCode == HttpStatus.NOT_FOUND.value()) { modelAndView.setViewName("404"); } else if (statusCode >= 500) { modelAndView.setViewName("500"); } else { modelAndView.setViewName("error"); } return modelAndView; } return new ModelAndView("error"); } } ``` 在这个例子中，我们检查了请求的错误状态码，根据不同的状态码返回相应的视图。注意，`@RequestMapping(value = ERROR_PATH)`注解使得Spring Boot知道这个控制器是用来处理错误的。此外，如果你想在错误页面显示更多的信息，比如日志或自定义消息，你可以利用`ErrorAttributes`。这个接口提供了获取错误详情的方法，如`getErrorAttributes(Request, boolean)`。你可以注入`ErrorAttributes`到你的`CustomErrorController`，然后在`error()`方法中使用这些信息。如果你的应用是基于Maven或Gradle构建的，确保在`pom.xml`或`build.gradle`文件中添加对Thymeleaf或FreeMarker等模板引擎的支持，以便能够解析和渲染HTML模板。总结来说，自定义Spring Boot的错误页面涉及创建自定义的HTML模板，创建实现`ErrorController`的类，以及可能的利用`ErrorAttributes`获取错误信息。通过这种方式，你可以创建更加符合你应用风格和需求的错误处理机制，从而提高用户体验。

如果你在使用 Thymeleaf 时遇到了页面报错，可以查看控制台输出的错误信息，找到具体的问题所在。常见的错误包括语法错误、模板引用错误、标签使用错误等等。如果你想利用 Thymeleaf 自定义错误页面，可以按照以下步骤进行： 1. 首先在 `src/main/resources/templates` 目录下创建一个 `error` 目录。在该目录下创建一个名为 `error.html` 的 Thymeleaf 模板文件。 2. 在 `application.properties` 文件中配置错误处理的地址： ``` server.error.path=/error ``` 3. 创建一个名为 `ErrorController` 的控制器类，用于处理错误请求： ```java @Controller public class ErrorController implements org.springframework.boot.web.servlet.error.ErrorController { @RequestMapping("/error") public String handleError(HttpServletRequest request, HttpServletResponse response) { // 获取错误状态码 Integer statusCode = (Integer) request.getAttribute("javax.servlet.error.status_code"); // 根据状态码返回不同的错误页面 if (statusCode == 404) { return "error/404"; } else { return "error/500"; } } @Override public String getErrorPath() { return "/error"; } } ``` 4. 在 `error` 目录下创建 `404.html` 和 `500.html` 两个 Thymeleaf 模板文件，用于显示不同类型的错误页面。例如，`404.html` 可以这样编写： ```html <!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>404 Not Found</title> </head> <body> <h1>404 Not Found</h1> <p>您请求的页面不存在，请检查您输入的地址是否正确。</p> </body> </html> ``` 5. 访问不存在的页面，尝试触发 404 错误，可以看到自定义的错误页面。如果你想测试 500 错误，可以在控制器中抛出一个异常，例如： ```java @RequestMapping("/test") public String test() { throw new RuntimeException("测试错误"); } ``` 然后访问 `/test` 地址即可。

阅读全文

thymeleaf 使用页面报错_SpringBoot 利用thymeleaf自定义错误页面

相关推荐

SpringBoot页面展示Thymeleaf

显示自定义错误页面，用户自定义

java开发oa系统源码下载-RuoYi_SpringBoot_Thymeleaf:RuoYi_SpringBoot_Thymeleaf

springboot开发博客资料_springboot博客_springboot_springboot开发博客资料_

Thymeleaf中文参考手册_3.0.5版_thymeleaf_thymeleaf中文网_thymeleaf文档_thmele

market-goods_springboot_springbootlayui_boymhz.zip

thymeleaf demo 超简单,springboot

lcg0124-bootdo-master.zip_bootDo_shiro springboot_springboot_thy

springboot-mvc-thymeleaf-crud：Projeto SpringBoot MVC与Thymeleaf和MySQL

springboot_maven_thymeleaf:springboot_thymeleaf demo 会陆续加入新的功能

Thymeleaf模板引擎简介与SpringBoot整合入门

demo_javaweb_java_springboot_DEMO_

springboot_Demo.zip_DEMO_springboot Demo

springboot_pdf.zip_java_remember564_societyund_spring_springboot

thymeleaf页面静态化springboot

java_springboot_crud

cursomc_SpringBoot

Jm_SpringBoot_Bootstrap_1

Thymeleaf模板引擎入门与SpringBoot集成教程

最新推荐

浅析SpringBoot中使用thymeleaf找不到.HTML文件的原因

day16_springboot_笔记

SpringBoot页面跳转访问css、js等静态资源引用无效解决.docx

Thymeleaf显示base64字符串为图片.docx

springboot 自定义LocaleResolver实现切换语言

全国江河水系图层shp文件包下载

管理建模和仿真的文件

Keras模型压缩与优化：减小模型尺寸与提升推理速度

MTK 6229 BB芯片在手机中有哪些核心功能，OTG支持、Wi-Fi支持和RTC晶振是如何实现的？

点云二值化测试数据集的详细解读