致力于解决@EnableWebMvc注解导致swagger-ui.html 404报错问题，您不容错过的最佳指南

2023-03-21 00:27:38

解决@EnableWebMvc注解导致的Swagger-ui.html 404错误：终极指南

简介

在Spring MVC项目中使用Swagger时，开发者可能遇到一个常见的错误：当访问swagger-ui.html时，出现404错误。本文将深入探讨这一问题的根源，并提供两种全面的解决方案，帮助您轻松解决此问题。

错误的根源：

@EnableWebMvc注解

@EnableWebMvc是Spring MVC提供的注解，用于自动配置Spring MVC的Web应用程序上下文。它会创建DispatcherServlet和ViewResolver等必要组件，以便处理HTTP请求。然而，当同时使用Swagger时，它可能会导致404错误。

原因在于，@EnableWebMvc注解将Spring MVC的默认静态资源路径（如/webjars/swagger-ui/）映射到DispatcherServlet。而swagger-ui.html是一个静态资源文件，它不应该由DispatcherServlet处理。

解决方案 1：去掉@EnableWebMvc注解

一种直接的解决方案是去掉@EnableWebMvc注解。这会禁用Spring MVC的自动配置，让您手动配置Spring MVC的组件。

解决方案 2：自定义WebMvc配置类

一种更优雅的解决方案是创建一个自定义的WebMvc配置类，实现WebMvcConfigurer接口，并添加以下代码：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
    }

}