开发喵星球

Knife4j是Swagger的增强版本，提供了更多功能和更好的用户体验。

1.引入依赖

位置：ruoyi-admin模块的pom.xml文件

<!-- Knife4j 增强Swagger文档 -->
<dependency>     
    <groupId>com.github.xiaoymin</groupId>     
    <artifactId>knife4j-spring-boot-starter</artifactId> 
    <version>3.0.3</version>
</dependency>

2.修改配置

2.1配置类添加注解

在配置类中添加@EnableSwagger2和@EnableKnife4j

位置：ruoyi-admin/src/main/java/com/ruoyi/web/core/config/SwaggerConfig.java

@EnableSwagger2
@EnableKnife4j

2.2去除swagger项目路径

// 去除swagger项目路径
//.pathMapping(pathMapping);

3.添加白名单放行

在ruoyi-framework模块下的config包中的SecurityConfig.java文件中添加白名单路径，允许访问 Knife4j 文档页面：

.antMatchers("*/doc.html").anonymous()

通过以上步骤，即可将项目从Swagger升级到Knife4j，并配置了相应的依赖、注解和白名单路径放行。

swagger访问地址

http://localhost:8080/swagger-ui/index.html#/

knife4j访问地址

http://localhost:8080/doc.html#/home

可以根据你的实际需求和项目情况进行相应的调整。