版本对照
knife4j-next 版本 vs Spring Boot 版本
| knife4j-next 版本 | Spring Boot 2.x | Spring Boot 3.x | Spring Boot 4.x | 说明 |
|---|---|---|---|---|
5.6.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 当前版本，浏览器登录会话调试、枚举过滤与目录吸顶 |
5.5.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | OAS 3.1 / JSON Schema 2020-12、受控资源、调试诊断与导出 |
5.4.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 接口工作区、本地数据清理与单接口 OpenAPI 3.0.x 下载 |
5.3.3 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 动态表单参数补丁 |
5.3.2 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 离线文档请求与响应示例补丁 |
5.3.1 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 离线导出契约与请求参数批量选择补丁 |
5.3.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | React UI 两级请求参数与配置入口拆分 |
5.2.4 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | React UI 固定布局与区域滚动补丁 |
5.2.3 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 聚合路由请求头补丁 |
5.2.2 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 调试枚举/分组校验与文档展示补丁 |
5.2.1 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 响应文档与调试编辑器补丁 |
5.2.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.16 | ✅ 4.0.7 | 分组级全局参数与依赖维护 |
5.1.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 前端体验与国际化 |
5.0.18 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.17 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.16 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.15 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.14 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.13 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.12 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.11 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.10 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.9 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.8 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.7 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.6 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.5 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.4 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.3 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.2 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.1 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ✅ 4.0.6 | 补丁修复版本 |
5.0.0 | ✅ 2.7.18 | ✅ 3.4.0 ~ 3.5.0 | ❌ | 首个正式稳定版本 |
knife4j-next 从
5.0.0起采用独立 SemVer 版本号，与上游 knife4j 版本号无关。5.6.0包含 Boot4 WebMVC starter、Boot4 Gateway starter、Boot4 独立聚合 starter，以及 Boot 3.5 Gateway Server Web MVC 聚合 starter；可直接使用com.baizhukui:knife4j-openapi3-boot4-spring-boot-starter:5.6.0、com.baizhukui:knife4j-gateway-boot4-spring-boot-starter:5.6.0、com.baizhukui:knife4j-aggregation-boot4-spring-boot-starter:5.6.0和com.baizhukui:knife4j-gateway-webmvc-spring-boot-starter:5.6.0。
核心依赖版本
以下为 knife4j-next 5.6.0 内部管理的依赖版本，用户一般不需要手动指定。
Boot 2.x（非 Jakarta）线
| 依赖 | 版本 |
|---|---|
| Spring Framework | 5.3.31 |
| Spring Boot | 2.7.18 |
| Springfox | 2.10.5 |
| springdoc-openapi | 1.8.0 |
| Swagger 2 models | 1.6.14 |
| Servlet API | 4.0.1 |
Boot 3.x（Jakarta）线
| 依赖 | 版本 |
|---|---|
| Spring Framework | 6.2.0 |
| Spring Boot | 3.4.0 |
| springdoc-openapi Jakarta | 2.8.9 |
| Swagger v3 Jakarta models | 2.2.47 |
| Servlet Jakarta API | 6.1.0 |
smoke-tests 中
boot3-jakarta-app使用 Boot3.4.5，boot35-jakarta-app使用 Boot3.5.0，boot35-gateway-webmvc-app使用 Boot3.5.16，均通过验证。
Boot 4.x（Jakarta）线
| 依赖 | 版本 |
|---|---|
| Spring Boot | 4.0.7 |
| Spring Cloud | 2025.1.2（Gateway 5.x） |
| springdoc-openapi | 3.0.3 |
| Swagger v3 models | 2.2.47 |
| Servlet Jakarta API | 6.1.0 |
smoke-tests 中
boot4-jakarta-app、boot4-gateway-app与boot4-aggregation-app使用 Boot4.0.7，通过验证。
其他共享依赖
| 依赖 | 版本 |
|---|---|
| Java 最低版本 | 1.8（非 Jakarta）；17（Jakarta / Boot4） |
| SLF4J | 2.0.18 |
| Gson | 2.11.0 |
| Javassist | 3.30.2-GA |
| Lombok | 1.18.46 |
Upstream 版本对照
| upstream 版本 | knife4j-next 版本 | 说明 |
|---|---|---|
4.5.0（上游 Maven Central 最后发布版本） | 5.6.0 | 当前版本：包含已合并兼容/安全修复、Boot 3.4/3.5/4.0 兼容及 OAS 3.1 支持 |
4.5.0 | 5.4.0 | React UI 工作区与本地数据治理能力 |
4.5.0 | 5.3.3 | React UI 动态表单参数补丁 |
4.5.0 | 5.3.2 | React UI 离线文档请求与响应示例补丁 |
4.5.0 | 5.3.1 | React UI 离线导出契约与请求参数批量选择补丁 |
4.5.0 | 5.3.0 | React UI 两级请求参数与配置入口拆分 |
4.5.0 | 5.2.4 | React UI 固定布局与区域滚动补丁 |
4.5.0 | 5.2.3 | 聚合路由请求头补丁 |
4.5.0 | 5.2.2 | 调试枚举/分组校验与文档展示补丁 |
4.5.0 | 5.2.1 | 响应文档与调试编辑器补丁 |
4.5.0 | 5.2.0 | React UI 分组级全局参数与依赖维护 |
4.5.0 | 5.1.0 | 前端体验与国际化 |
4.5.0 | 5.0.18 | 补丁修复版本 |
4.5.0 | 5.0.17 | 补丁修复版本 |
4.5.0 | 5.0.16 | 补丁修复版本 |
4.5.0 | 5.0.15 | 补丁修复版本 |
4.5.0 | 5.0.14 | 补丁修复版本 |
4.5.0 | 5.0.13 | 补丁修复版本 |
4.5.0 | 5.0.12 | 补丁修复版本 |
4.5.0 | 5.0.11 | 补丁修复版本 |
4.5.0 | 5.0.10 | 补丁修复版本 |
4.5.0 | 5.0.9 | 补丁修复版本 |
4.5.0 | 5.0.8 | 补丁修复版本 |
4.5.0 | 5.0.7 | 补丁修复版本 |
4.5.0 | 5.0.6 | 补丁修复版本 |
4.5.0 | 5.0.5 | 补丁修复版本 |
4.5.0 | 5.0.4 | 补丁修复版本 |
4.5.0 | 5.0.3 | 补丁修复版本 |
4.5.0 | 5.0.2 | 补丁修复版本 |
4.5.0 | 5.0.1 | 补丁修复版本 |
4.5.0 | 5.0.0 | 首个正式稳定版本 |
如何确认你项目中的实际版本
mvn dependency:tree -Dincludes=com.baizhukui
mvn dependency:tree -Dincludes=org.springdoc
mvn dependency:tree -Dincludes=org.apache.commons:commons-lang3如果 springdoc 版本与上表不一致，说明你的项目中有其他依赖覆盖了版本管理。请检查是否有 BOM 或父 POM 引入了不同版本的 springdoc。
如果安全扫描提示 CVE-2025-48924，重点确认 commons-lang3 是否低于 3.18.0。使用 Spring Boot parent 或 Spring Boot BOM 的应用可能会把 starter 传递声明的 commons-lang3 版本重新管理回 Boot 自带版本；这种情况下需要在应用侧 dependencyManagement 中显式覆盖到 3.20.0 或更高版本。