跳到主要内容
xzzlog

Spring Boot 3.5.16 是 3.5.x 最后一个 OSS 版本:存量项目现在该怎么升

Spring Boot 3.5.16 是 3.5.x 最后一个 OSS 版本。按 Maven 或 Gradle 更新存量项目,核对实际依赖与测试,再独立评估 Boot 4 的模块、容器和 Jackson 迁移。

文章目录
大陆访问,精品线路|搬瓦工 · CN2 GIA / CTGNet 套餐
RackNerd:海外VPS21.99美元每年起
DMIT:Premium中国大陆优化线路CN2GIA
云服务器,积分可续期|雨云 · 国内外节点 · 积分兑换权益
腾讯云:锐驰型200Mbps峰值带宽,中国内地2核2G50元每月
WorkBuddy:交代任务,交付文件
晚安云:香港云服务器2核2G15元每月
Evoxt:最高6.0GHz CPU,2.99美元每月起
LisaHost:原生与住宅IP产品,按套餐选择
野草云:香港200Mbps峰值带宽,不限月流量,30元每月起
BRNCHost:Bursa土耳其游戏服务器,1Gbps端口,DDoS防护
京东云:AI进入真实业务

Spring Boot 3.5.16 是 3.5.x 最后一个 OSS 版本:存量项目现在该怎么升

Spring Boot 3.5.x 存量项目需要安排两项工作:把当前分支升级到最后一个 OSS 补丁版本,并为 Boot 4 建立独立的迁移验证分支。不要把两项改动混在一次生产发布里,否则遇到依赖或行为变化时很难定位。

官方发布公告确认,3.5.16 于 2026 年 6 月 25 日发布,包含三项依赖升级,也是 3.5.x 最后一个 OSS release。仍需 OSS 维护的团队应评估升级到 4.0.x 或 4.1.x;官方也提供商业支持选项。升级到 3.5.16 可以完成该分支的补丁更新,但不会让它重新进入 OSS 维护期。

先记录现有版本和可恢复的部署产物

在修改前保存当前构建文件、依赖解析结果、运行配置和镜像标识。记录 CI 与生产实际使用的 JDK,不要只看开发电脑上的 java -version。

3.5.16 的系统要求至少是 Java 17。如果项目锁定了第三方 starter、驱动或其他 BOM,先列出这些覆盖项;版本号已改并不能证明运行时用上了预期依赖。

Maven 项目改哪里

继承 spring-boot-starter-parent 的项目,把父版本改为 3.5.16。下面是 pom.xml 中的局部片段,不是完整项目文件:

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.16</version>
    <relativePath/>
</parent>

如果项目使用公司父 POM,则按现有方式更新导入的 spring-boot-dependencies BOM;不要为了升级覆盖公司父配置。官方 Maven 插件文档说明,单独导入 BOM 提供依赖管理,不能代替父 POM 的插件管理,相关构建插件版本仍需检查。

有 Maven Wrapper 的项目,可在相应项目目录执行:

./mvnw help:effective-pom
./mvnw dependency:tree
./mvnw verify

没有 Wrapper 时使用项目约定的 Maven。多模块工程还要核对父模块和目标应用模块,确认实际解析出的版本;verify 只会运行项目已经配置的生命周期检查,缺失的集成测试需要另行补上。

Gradle 项目检查插件与依赖管理

使用 Groovy DSL 的项目,已有插件声明中可以更新为:

plugins {
    id 'org.springframework.boot' version '3.5.16'
}

这也是局部片段,保留项目原有的 Java、Kotlin、依赖管理和其他插件。使用版本目录或根工程统一管理插件时,修改真正生效的版本来源,不在子模块重复声明。仅应用 Boot 插件不等于完整设置了依赖管理,按项目现有的 BOM 或 dependency-management 方式检查。

在应用模块检查运行时依赖和构建结果:

./gradlew dependencies --configuration runtimeClasspath
./gradlew check bootJar

多模块项目需指定对应模块任务;Windows 使用相应的 Wrapper 脚本。check 能覆盖哪些测试由构建配置决定,bootJar 产出成功也不代表业务行为已经验证。插件配置可对照官方 Gradle 文档。

3.5.16 发布前验证哪些行为

先在测试环境使用与生产一致的配置结构和依赖服务,再检查业务路径。至少覆盖登录和授权、重要接口的 JSON 输出、数据库事务、消息或定时任务、健康检查,以及实际镜像的启动方式。

保存升级前后的接口样本、测试记录和镜像标识。若集成测试依赖外部服务,要确认 CI 确实启动了这些服务,没有跳过对应检查。需要核对容器网络、数据卷和健康检查的读者,可继续看Spring Boot 与 PostgreSQL 的 Compose 部署契约。

部署回退也应单独验证。如果应用发布同时改变了数据库结构、消息格式或配置,切回旧镜像未必能恢复兼容性;先判断这些变化是否允许旧版本继续运行。

Boot 4 的迁移分支重点看什么

官方 Boot 4.0 迁移指南建议先升级到最新 3.5.x,再清理弃用用法、检查依赖和系统要求。不要直接把所有依赖都手工改成“最新”,优先使用目标 Boot 版本的依赖管理,并单独确认 Spring Cloud 和第三方 starter 的兼容版本。

其中几项变化值得先做小范围验证:

  • Boot 4.0 使用 Spring Framework 7,并以 Servlet 6.1 为基线;部署 WAR 或依赖特定嵌入式容器时,要检查目标容器支持情况。
  • Boot 4.0 引入更细的模块划分,部分能力需要相应 starter,包路径和测试依赖也可能需要调整。
  • Boot 4 优先使用 Jackson 3。自定义序列化、ObjectMapper 配置和依赖 Jackson 2 的库,需要按迁移指南逐项验证。

不要因为应用能启动就结束迁移。用相同业务样本比较升级前后的状态码、字段、日期格式、事务结果和授权行为,问题才能落到具体接口或配置。3.5.16 的依赖更新与 Boot 4 的迁移验证各自保存记录,满足发布条件后分别上线。

继续阅读 返回顶部