1.找到

1. ruoyi-common-swagger
2. ruoyi-modules-system
3. ruoyi-modules-file
4. ruoyi-modules-gen
5. ruoyi-modules-job

 目录下的pom.xml,将maven配置的springfox-swagger2 注释或删除

<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>${swagger.fox.version}</version>
 </dependency>

2.ruoyi-common-swagger新增以下 springfox-swagger 3.0.0+ knife4j maven配置

 代码：

<!-- swagger2 - knife4j -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>${swagger.fox.version}</version>
            <scope>compile</scope>
        </dependency>

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

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

3.在ruoyi-modules-system，ruoyi-modules-file，ruoyi-modules-gen，ruoyi-modules-job服务项目的pom中，注释原有Swagger，新增springfox-swagger 3.0.0+ knife4j maven配置

 

 代码：

<!-- swagger2 - knife4j -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>${swagger.fox.version}</version>
            <scope>compile</scope>
        </dependency>

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

4.在SwaggerAutoConfiguration配置类上新增@EnableKnife4j 注解

5. 在认证模块 ruoyi-auth 中新增 knife4j maven配置

代码：

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

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

 6.在SwaggerWebConfiguration中放行 doc.html 静态路径

代码： 

/** swagger-ui 地址 */
registry.addResourceHandler("doc.html").addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
registry.addResourceHandler("/swagger-ui/**").addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/");

7. mvn  clean/install

8.聚合成功的前提是，每个应用端都能正常访问

swagger接口 http://localhost:9203/swagger-ui/index.html

knife4j整合访问地址 : http://localhost:8080/doc.html

 8.统一授权

通过接口访问授权接口获取token 6.2、在swagger或knife4j上添加全局参数，后续访问接口都会携带这些参数