解决springdoc-openapi-ui(Swagger3)跳转默认界面问题

我可能在扯淡2024-12-29 22:40

文章目录

- - 问题现象
  - 解决方法

问题现象

项目正确引入springdoc-openapi-ui依赖，但是访问/swagger-ui/index.html界面时，跳转到了默认的界面，如下图所示：

解决方法

1、升级maven依赖为1.8.0以上：

xml 复制代码

<dependency>
	<groupId>org.springdoc</groupId>
	<artifactId>springdoc-openapi-ui</artifactId>
	<version>1.8.0</version>
</dependency>

2、增加springdoc的url配置：

yaml 复制代码

springdoc:
  swagger-ui:
    enabled: true # 开启swagger界面
    url: /cxhl/v3/api-docs # 自定义搜索路径
    #path: swagger-ui.html # 自定义路径，默认为"/swagger-ui/index.html"

修改后的界面，如下图所示：

项目中的接口文档都出来了，完美解决！