Java 8 升级到 Java 25:Spring Boot 2.4 → 4.1 老项目升级(开源示产品系统

我要开发同款
javajet2026年11月17日
5阅读

技术信息

语言技术
Java、SpringMVC、Spring、Mybatis
系统类型
Web、Linux
行业分类
企业服务、内容平台

作品详情

行业场景

很多企业的 Java 后端还停留在 Java 8 / Spring Boot 2:官方已停止维护,安全补丁跟不上,依赖仓库陆续关闭,有的老项目甚至已经构建不起来。
本作品选取开源的 Spring Boot RealWorld 后端(MIT 许可,2021 年版本,典型的 REST + JWT + MyBatis 架构)作为示范,演示如何把这类老项目一步升级到 Java 25 / Spring Boot 4,同时保证接口和数据格式不变、业务不受影响。不含任何客户代码或数据。

功能介绍

项目本身是一个博客类 REST 后端:用户注册登录(JWT 认证)、文章发布与列表、评论、收藏、关注、标签。
本次升级的工作内容:
1、构建:Gradle 6.6 → 9.2,Spring Boot 2.4 → 4.1,Java 8 → 25;去掉已关闭的 jcenter 和代码中没用到的依赖,其余依赖全部固定版本;
2、代码迁移:javax → jakarta;Spring Security 改为 SecurityFilterChain 写法;Jackson 2 → 3;Joda-Time → java.time;jjwt 0.9 → 0.13;
3、测试:JUnit 4 → JUnit 5,70 个测试全部通过,编译过时警告清零;
4、交付:按类别拆分的 9 个提交、升级说明文档(MIGRATION.md)和行为变化清单。

项目实现

由我独立完成全部升级、测试和文档。亮点与难点:
1、发现 2021 年的原项目今天已无法构建(jcenter 关闭、有依赖写的是“最新版”),先恢复可重复构建再升级;
2、JWT 密钥:用真实的旧版 jjwt 0.9.1 实测,发现它解码密钥时悄悄跳过了“-”和“_”,HS512 密钥实际只有 480 位;新版库拒绝短密钥,所以上线后老令牌失效、用户需重新登录一次。这个结论写进了升级说明,并用回归测试固定;
3、日期 JSON 格式保持不变(始终 3 位毫秒),数据库存储格式不变,老数据可直接读取;顺带修掉了旧代码里多线程共用 Calendar 的隐患;
4、打出的 jar 在 Java 25 上实际启动,注册、发文、匿名列表、标签、表单校验(422)、未登录访问(401)逐个调用验证。

示例图片

声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态

评论