springboot整合swagger3.0.0，swagger-ui.html报404

最新推荐文章于 2025-07-07 18:42:17 发布

bulosli

最新推荐文章于 2025-07-07 18:42:17 发布

阅读量1.2k

点赞数 3

CC 4.0 BY-SA版权

文章标签： swagger2

本文链接：https://blog.youkuaiyun.com/qq_34831748/article/details/117441010

博主导入Swagger相关依赖后，访问http://localhost:8080/swagger-ui.html报404错误。经查询发现springfox - boot - starter中的SwaggerUiWebMvcConfigurer对地址进行了映射，正确地址应为swagger - ui/index.html，按此修改后问题成功解决。

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

我导入的依赖

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>3.0.0</version>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>3.0.0</version>
        </dependency>

SwaggerConfig.java

import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
}

访问：http://localhost:8080/swagger-ui.html

报404

我在想地址错了吗？

后面查到springfox-boot-starter中的SwaggerUiWebMvcConfigurer对地址进行了映射。地址和以前不一样了

// tag::swagger-ui-configurer[]
public class SwaggerUiWebMvcConfigurer implements WebMvcConfigurer {
  private final String baseUrl;

  public SwaggerUiWebMvcConfigurer(String baseUrl) {
    this.baseUrl = baseUrl;
  }

  @Override
  public void addResourceHandlers(ResourceHandlerRegistry registry) {
    String baseUrl = StringUtils.trimTrailingCharacter(this.baseUrl, '/');
    registry.
        addResourceHandler(baseUrl + "/swagger-ui/**")
        .addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/")
        .resourceChain(false);
  }

  @Override
  public void addViewControllers(ViewControllerRegistry registry) {
    registry.addViewController(baseUrl + "/swagger-ui/")
        .setViewName("forward:" + baseUrl + "/swagger-ui/index.html");
  }
}
// end::swagger-ui-configurer[]

这里的地址应该是：swagger-ui/index.html

成功解决。