springboot 2配置全局错误管理

最新推荐文章于 2025-11-11 21:16:13 发布

原创最新推荐文章于 2025-11-11 21:16:13 发布 · 3.1k 阅读

1 ·

CC 4.0 BY-SA版权

springboot2 同时被 2 个专栏收录

12 篇文章

订阅专栏

springboot2

7 篇文章

订阅专栏

在SpringBoot 1.x中，我们可以通过特定方式实现错误页面跳转，但在SpringBoot 2.x中，这种方法不再适用。文章介绍了如何利用ErrorPageRegistrar接口来实现SpringBoot 2的全局错误管理。当遇到如404 NOT_FOUND等错误时，系统将根据配置自动跳转到对应的错误页面，配合自定义Controller实现优雅的错误展示。

springboot1的时候我们可以使用如下方式实现错误跳转不同页面

    @Bean
    public EmbeddedServletContainerCustomizer containerCustomizer() {
        return new EmbeddedServletContainerCustomizer() {
            @Override
            public void customize(ConfigurableEmbeddedServletContainer container) {
                ErrorPage error401Page = new ErrorPage(HttpStatus.UNAUTHORIZED, "/401");
                ErrorPage error405Page = new ErrorPage(HttpStatus.METHOD_NOT_ALLOWED, "/405");
                ErrorPage error404Page = new ErrorPage(HttpStatus.NOT_FOUND, "/404");
                ErrorPage error500Page = new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/500");

                container.addErrorPages(error401Page,error405Page, error404Page, error500Page);
            }
        };
    }

但是在springboot2中找不到这个方法了，通过文档介绍可以实现ErrorPageRegistrar接口来完成

@Component
public class ErrorConfigurar implements ErrorPageRegistrar {

    @Override
    public void registerErrorPages(ErrorPageRegistry registry) {
        ErrorPage[] errorPages=new ErrorPage[2];
        errorPages[0]=new ErrorPage(HttpStatus.NOT_FOUND,"/error404");
        errorPages[1]=new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR,"/error500");

        registry.addErrorPages(errorPages);
    }
}

ErrorPage中第一个参数是错误的状态，第二个参数是发生这个错误要跳转的链接，比如NOT_FOUND是404的错误代码，发生404的时候就会跳转到error404的链接，我们再配置一个controller，用于控制跳转错误页面

@Controller
public class ErrorController {

    @RequestMapping("error404")
    public String error404(){
        return "404";
    }
    @RequestMapping("error500")
    public String error500(){
        return "500";
    }
}