Knife4j Next更现代的 Knife4j

这是 Knife4j 的 fork，不是重写 ​

knife4j-next 是 xiaoymin/knife4j 的社区维护分支。

• 保留 com.github.xiaoymin.knife4j.* Java 包名，不做重命名。
• 保留 doc.html / v2/api-docs / v3/api-docs 访问入口。
• 保留 @ApiOperationSupport、@ApiSupport、knife4j.* 等全部既有注解与配置键。
• 只改 groupId：com.github.xiaoymin → com.baizhukui，其余业务代码不用动。

60 秒上手 ​

Spring Boot 3.x（Jakarta）：

<dependency>
    <groupId>com.baizhukui</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>5.0.8</version>
</dependency>

最小配置（使用 springdoc 默认 /v3/api-docs 和 /swagger-ui.html）：

knife4j:
  enable: true

knife4j.setting.language 默认就是 zh_cn；springdoc.swagger-ui.path 和 springdoc.api-docs.path 也沿用 springdoc 默认值即可。真实项目可按需补充 springdoc.packages-to-scan、paths-to-match 或 swagger-ui.tags-sorter 等扫描与排序配置。

启动应用后访问 http://localhost:8080/doc.html。完整流程见 快速开始。

5.0.8 版本亮点 最新 ​

• 🛠 修复 Jakarta 独立聚合 cloud 路由缺少 servicePath 时 swagger-config 返回 500 的问题
• 🧭 React UI 支持按 Knife4j 扩展字段 x-order 排序 tag 与 operation
• 🧪 smoke 覆盖扩展到 Boot 2 / Boot 3 WebFlux、Gateway 与独立聚合场景
• 📚 README、版本文档和 agent 协作流程继续收敛，发布前状态更容易核验
• 🧩 继续包含 Boot4 WebMVC 与 Boot4 Gateway starter，覆盖 Spring Boot 4.x 入口

完整更新列表见 发布说明。

文档导航 ​

上手

• 产品介绍：这个 fork 的定位、与 upstream 的对照表
• 快速开始：Spring Boot 2.x / 3.x / 4.x 完整接入
• 迁移指引：从 com.github.xiaoymin 切到 com.baizhukui
• Demo 预览：knife4j-demo-openapi3（OpenAPI 3）与 knife4j-demo-openapi2（OpenAPI 2）两条线的本地跑 / Docker Compose
• 常见问题：doc.html 404、生产环境禁用、Nginx 反向代理、React 配置不生效

组件

• Gateway 聚合：Spring Cloud Gateway + knife4j-gateway-starter
• Aggregation 聚合：disk / cloud / nacos / eureka / polaris
• WebFlux 方案：当前 fork 中的 webflux 实际情况与替代路径

参考

• 兼容矩阵：Java、Spring、Boot、springdoc 基线
• 版本参考表：Boot 版本如何选 knife4j 版本
• 模块说明：Maven 模块的职责与选择决策
• 配置参考：全部 knife4j.* YAML 选项
• 注解速查：Springfox 专有 vs 通用注解

其他

• 路线图：当前任务队列 + React UI 覆盖缺口清单
• 发布说明：版本更新记录