Spring Boot自定义Http Status错误页面

最新推荐文章于 2025-06-13 20:27:15 发布

袁荣坤的csdn

最新推荐文章于 2025-06-13 20:27:15 发布

阅读量1.5k

点赞数

CC 4.0 BY-SA版权

分类专栏：笔记文章标签： spring boot http status

本文链接：https://blog.youkuaiyun.com/jasstool/article/details/82020463

笔记专栏收录该内容

18 篇文章

订阅专栏

本文介绍如何在SpringBoot项目中自定义错误页面，避免默认错误界面影响用户体验。使用ConfigurableServletWebServerFactory替代已废弃的EmbeddedServletContainerCustomizer，通过HttpStatus映射不同错误页面。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在做spring boot项目的过程中，老是出现出错界面，一律跳到spring boot默认的错误显示界面，极大的影响用户体验，于是开始在网上寻找相关的解决办法，出现最多的是使用EmbeddedServletContainerCustomizer类进行相关的页面定义，但是在使用过程中，却被告知该类已被删除，也没告诉我用什么替换。
后来在网上搜到一个问答上解决了这个问题，在此记录一下，用ConfigurableServletWebServerFactory替换EmbeddedServletContainerCustomizer，具体代码如下：

import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.ErrorPage;
import org.springframework.boot.web.servlet.server.ConfigurableServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.HttpStatus;

@Configuration
public class ServerConfiger {
    @Bean
    public ConfigurableServletWebServerFactory webServerFactory() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
        factory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND , "/login-error"));
        factory.addErrorPages(new ErrorPage(HttpStatus.FORBIDDEN , "/login-forbidden"));
        factory.addErrorPages(new ErrorPage(HttpStatus.METHOD_NOT_ALLOWED, "/method-not-allowed"));
        factory.addErrorPages(new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/method-not-allowed"));
        return factory;
    }
}

通过相应的Http status来确定进入的路径。