1 添加依赖
1.1 项目父级pom.xml
在项目的跟pom.xml(ruoyi)添加knife4j-spring-boot-starter和knife4j-micro-spring-boot-starter依赖。
版本使用3.0.3
- 文件位置
- 截图
- 代码
<knife4j.version>3.0.3</knife4j.version>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>${knife4j.version}</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-micro-spring-boot-starter</artifactId>
<version>${knife4j.version}</version>
</dependency>
1.2 ruoyi-common-swagger的pom.xml
-
文件位置
添加knife4j-spring-boot-starter依赖 -
截图
-
代码
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
</dependency>
1.3 ruoyi-gateway的pom.xml
- 文件位置
添加knife4j-spring-boot-starter和knife4j-micro-spring-boot-starter依赖
- 截图
- 代码
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-micro-spring-boot-starter</artifactId>
</dependency>
2 SwaggerProvider.java添加@Primary注解
- 文件位置
- 截图
- 代码
@Component
@Primary
public class SwaggerProvider implements SwaggerResourcesProvider, WebFluxConfigurer
{
# 代码
}
3 修改系统菜单路由
其中8200是ruoyi-gateway模块的服务端口
4 修改配置ruoyi-gateway-dev.yml
前往nacos的配置中心,编辑ruoyi-gateway-dev.yml
将路由id为ruoyi-system的节点放在最前面
5 效果
重启一下所有服务,访问http://localhost:8200/doc.html#/home
,或从系统工具菜单的系统接口进入文档管理页面,增强后的文档管理界面如下: