swagger2的 3.0.0版本接入swagger-ui.html 404 报错

最新推荐文章于 2025-06-27 10:34:29 发布

tgy_rb

最新推荐文章于 2025-06-27 10:34:29 发布

阅读量2.7k

点赞数 5

CC 4.0 BY-SA版权

分类专栏： java 文章标签： java

本文链接：https://blog.csdn.net/weixin_43832505/article/details/108827411

java 专栏收录该内容

11 篇文章

订阅专栏

本文介绍了解决Springfox Swagger UI页面404问题的方法，通过更新依赖并配置SwaggerUiWebMvcConfigurer实现正确的路径映射。

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

按照之前2.x.x 版本引入如下maven

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

项目运行，输入 http://127.0.0.1:8060/swagger-ui.html 一直报 404 错误，后来去 github的springfox 查看，推荐使用如下方式接入:

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

而入口的url，在 springfox.boot.starter.autoconfigure.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");
  }
}

即为 : http://127.0.0.1:8060/swagger-ui/index.html 或者 http://127.0.0.1:8060/swagger-ui/