开发喵星球

在Spring Cloud的微服务架构下，每个微服务并不需要引入前端的ui资源，因此在每个微服务的Spring Boot项目下，引入ruoyi-common-swagger提供的starter即可。

1、在ruoyi-gateway网关模块下，把knife4j依赖资源引入

<!-- knife4j -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-ui</artifactId>
    <version>3.0.3</version>
</dependency>
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>

2、在ruoyi-common-swagger系统接口模块下，把knife4j依赖资源引入

<!-- knife4j -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>

3、在其他ruoyi-xxxx-xxxx服务下，把ruoyi-common-swagger依赖资源引入

<!-- RuoYi Common Swagger -->
<dependency>
    <groupId>com.ruoyi</groupId>
    <artifactId>ruoyi-common-swagger</artifactId>
</dependency>

4、在SwaggerProvider.java类添加注解@Primary

@Primary

5、测试验证

访问http://{ip}:{port}/doc.html地址，出现如下图表示成功。

重复swagger依赖剔除
– 在ruoyi-common-swagger引用knife4j-spring-boot-starter依赖，其中的springfox-swagger2依赖可以删除。
– 在ruoyi-gateway引用knife4j-spring-ui、knife4j-spring-boot-starter依赖，其中的springfox-swagger-ui、springfox-swagger2依赖可以删除。