[Swagger3.0]swagger-ui.html无法访问的解决方案

最新推荐文章于 2025-06-02 09:14:56 发布

臧初之

最新推荐文章于 2025-06-02 09:14:56 发布

阅读量3.5w

点赞数 29

CC 4.0 BY-SA版权

文章标签： spring java swagger2

本文链接：https://blog.csdn.net/mmmm0584/article/details/117786055

本文介绍了解决Swagger 3.0版本访问swagger-ui.html时出现404错误的方法。通过更新依赖并使用@EnableOpenApi注解，访问路径更改为http://localhost:8080/swagger-ui/index.html。

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

在学习swagger的过程中，从maven仓库中，导入最新的swagger包，如下：

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

但是，在其他配置完全正确的情况下，在访问http://localhost:8080/swagger-ui.html时，会报404错误。
原因如下：
在swagger3.0中，swagger-ui.html的位置发生了变化，下图为swagger2.x与swagger3.0版本的区别：
在这里插入图片描述

在这里插入图片描述
解决方案：
在主程序上添加@EnableOpenApi 并且访问http://localhost:8080/swagger-ui/index.html

注意：在添加@EnableOpenApi 注解时，会报错，这是因为找不到相关依赖。
解决办法：去掉下面依赖

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

添加springfox-boot-starter依赖

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

运行结果如下：
在这里插入图片描述

参考博客：尝鲜刚发布的 SpringFox 3.0.0，以前造的轮子可以不用了