5.0.0发布重构升级 SpringBoot4 SpringCloud2025 JDK21 TypeScript · smallchill/SpringBlade

## 技术文档
+ 感谢大家对于`BladeX`长久以来的支持,现技术文档已经全面免费开放,无需认证、无需 star 即可访问查看
+ `BladeX`的发展离不开大家的信任,未来我们也将会持续反哺开源社区,提供更好用的产品与功能
+ SpringBlade[后端]:[https://www.yuque.com/bladex/springblade](https://www.yuque.com/bladex/springblade)
+ Saber[前端]:[https://www.yuque.com/bladex/saber](https://www.yuque.com/bladex/saber)

## 重要说明
1. 本次为破坏性升级,改动较多,请大家升级前务必备份好相关资料
2. cloud工程请见工程内对应目录的升级指南:`/doc/guide/SpringCloud-5.0升级适配指南.md`
3. boot工程请见工程内对应目录的升级指南:`/doc/guide/SpringBoot-5.0升级适配指南.md`
4. saber工程请见工程内对应目录的升级指南:`/doc/guide/Saber-5.0升级适配指南.md`
5. 以上升级指南已做好AI适配,若使用 claude code 或 codex 等工具,可直接读取文档后,进行自动升级适配。推荐指令如下:
> 请执行 SpringBlade Cloud 微服务版低版本 → 5.0 的升级任务。

> 【目标工程】<低版本 Cloud 工程路径,如 /xx/Workspaces/SpringBlade>(待升级)
> 【参照工程】/xx/Workspaces/SpringBlade(已完成 5.0 升级,其最新一个 commit 即本次升级的完整变更)
> 【升级指南】/xx/Workspaces/SpringBlade/doc/guide/SpringCloud-5.0升级适配指南.md

> 【执行要求】
> 1. 先通读升级指南,按其章节作为任务拆解与变更原理的纲领。
> 2. 读取参照工程最新 commit 的完整 diff 与文件清单,作为事实基准:
> 指南与 diff 冲突时以 diff 为准;diff 中存在但指南未提及的变更同样必须同步,不得遗漏。
> 3. 前置校验(任一不满足即停下报告,不要动手):
> - 目标工程 working tree 干净,且其 HEAD 与参照 commit 的父提交一致;
> - 依赖基座 blade-tool 5.0.0 已 mvn clean install 到本地仓库;
> - 本机 JDK 21 可用(5.0 后 java.version=21,JDK 17 编译必失败)。
> 4. 以 diff 的文件清单为完整性 checklist,逐文件、逐模块复刻到目标工程,
> 含删除文件与二进制文件;批量替换后必须抽查确认;
> 严禁做 diff 范围之外的任何重构、格式化或优化。

> 【验收门禁(全部通过才算完成)】
> 1. JDK 21 下执行 mvn clean install -DskipTests,全部模块出现 BUILD SUCCESS;
> 2. 目标工程与参照工程全目录比对(排除 .git/target/.idea 等构建产物),差异归零,
> 任何残留差异逐条解释原因;
> 3. 通过后沿用参照 commit 的原始提交信息进行 commit,严禁 push。

> 【汇报】完成后输出:文件清单核对结果、编译结果、目录比对结论,
> 以及执行中发现的所有「指南与 diff 不一致」之处。

## 更新日志
1. [升级]JDK 至 Java21 LTS
2. [升级]Spring 至 7.0.8
3. [升级]SpringBoot 至 4.1.0
4. [升级]SpringBootAdmin 至 4.1.1
5. [升级]SpringCloud 至 2025年1月2日
6. [升级]SpringCloud Alibaba 至 202510.0
7. [升级]Nacos 至 3.2.2
8. [升级]MybatisPlus 至 3.5.17
9. [升级]MybatisSpring 至 4.0.0
10. [升级]SpringDoc 至 3.0.3
11. [升级]Guava 至 33.6.0
12. [升级]mica-auto 至 4.0.1,适配 Boot4 注解处理器
13. [升级]maven-compiler-plugin 至 3.15.0
14. [替换]Web 容器由 Undertow 切换为 Tomcat11
15. [替换]接口文档由 Knife4j 改用 SpringDoc 原生 UI
16. [替换]Druid 切换为 druid-spring-boot-4-starter
17. [替换]spring-boot-starter-aop 替换为 aspectj
18. [新增]锁定 Jackson2 兼容栈,规避 Boot4 默认 Jackson3 差异
19. [新增]Swagger @ApiOrder 注解,支持接口文档自定义排序
20. [新增]SysCache、DictCache、UserCache 系统缓存工具类
21. [新增]全局异常适配 SF7 方法级校验与 404、413 处理
22. [新增]Saber 新增 validData、findColumn 自研工具函数
23. [优化]MybatisPlus IService 迁移至 spring.service 包
24. [优化]适配 Boot4 自动配置拆包,迁移底层模块 import
25. [优化]Servlet 编码配置前缀迁移为 spring.servlet.encoding
26. [优化]Spring7 空值注解统一迁移至 JSpecify 规范
27. [优化]重构代码生成模板,分离 backend 与 frontend 目录
28. [优化]Saber 前端页面全量重构为 script setup + TypeScript

最后提交信息为: :tada: 5.0.0.RELEASE 重构升级 SpringBoot4 SpringCloud2025 JDK21 TypeScript

下载

Saber-5.0.0.zip

SpringBlade-5.0.0.zip

SpringBlade-boot-5.0.0.zip

下载 Source code (zip)

下载 Source code (tar.gz)

下载

请输入验证码,防止盗链导致资源被占用

Java

https://gitee.com/smallc/SpringBlade.git

git@gitee.com:smallc/SpringBlade.git