外观
10 - JDK 版本演进与迁移:变更、验证与回滚
本篇围绕 JDK 8 → 11 → 17 → 21 → 25 的迁移路线,覆盖这些版本的相关特性与兼容边界,不作为最新 JDK 清单。
阅读指引
- 本文定位:工程闭环中的版本选择与发布验收:理解版本变化会影响哪些行为,再确定测试、上线和回滚步骤。
- 前置阅读:01 内存布局、04 垃圾回收提供运行时基础;收集器变更补 A,性能对照补 08 JVM 调优。
- 后续阅读:并发 13 虚拟线程实战验证执行模型迁移,Spring 26 AOT 与 Native Image 边界比较不同部署契约;二者是可选应用分支,不是普通 JDK 升级的必经步骤。
- 学习目标:能列出字节码、反射、Agent、GC、容器与编码变化的风险,用相同工作负载完成灰度对照,并明确回滚触发条件。
摘要
服务换用新 JDK 后,即使能启动,也可能在生成代理、读取文件或连接外部系统时失败;性能和资源占用也可能变化。迁移要检查三层兼容性:编译产物能否执行,依赖和工具能否工作,业务对外行为是否符合约定。本文沿着这三层展开,最后把测试结果转成上线条件和回滚步骤。
1. 现象:能启动不等于迁移完成
基础入口:先区分运行时、编译器与目标版本
Java 源码先由编译器转换为 class 文件,其中保存字节码和类型信息;JVM(Java 虚拟机)加载这些文件并执行程序,HotSpot 是 JVM 的一种实现。JDK(Java 开发工具包)包含运行时、编译器及诊断工具。因此,编译所用版本和运行所用版本是两个独立选择。安装了新 JDK,不代表 IDE、构建机、服务脚本和容器都在使用它。java -version 检查当前命令所用的运行时,javac -version 检查当前编译器,线上进程的版本还要单独确认。
升级至少有三个独立问题:旧产物能否在新运行时执行?新编译产物能否继续给旧运行时使用?第三方依赖、反射、Agent 和外部协议能否保持兼容?反射是程序在运行时查看或访问类成员的机制;Agent 是用于监控、插桩等工作的代理工具,插桩指向字节码插入或改写指令。这些路径可能直到某个请求到来才执行,所以启动成功只覆盖了部分兼容性。
使用 JDK 17 的 javac --release 8 可同时限制 Java 语言目标、class 版本和对应平台 API,但不会替你检查所有第三方 jar。相比之下,只写 -source 8 -target 8 仍可能误用编译机较新平台 API。先理解这个差别,再阅读第 3 节的产物验证。
LTS(Long-Term Support,长期支持)是发行商支持策略的概念,不是 OpenJDK 语言或虚拟机规范属性。它不意味着该版本永远无需更新,也不意味着不同发行版的补丁和授权条件完全相同。本文选择 8、11、17、21、25 为讨论节点,选型时仍需确认具体构建和供应商支持政策。
1.1 建立当前运行基线
教学场景:8 升 17 后启动成功,只有反射路径失败;17 升 21 后延迟变化,团队同时切 GC 和线程模型。前者说明测试没有覆盖延迟加载路径,后者同时改变多个变量,无法归因。
基线是升级前用于对照的运行环境与行为记录。先记录 vendor(发行商)、完整 update/build(更新版本与构建号)、操作系统与 CPU 架构、容器限制、启动参数、框架与 Agent。同为“JDK 17”不保证容器行为、安全更新或供应商补丁完全一致,只有主版本号不足以复现问题。
以下为环境盘点命令,PID 需替换为目标 Java 进程 ID。前三条检查当前命令启动的 JVM,后两条查询已经运行的目标进程:
bash
java -version
java -XshowSettings:vm -version
java -XX:+PrintFlagsFinal -version
jcmd PID VM.version
jcmd PID VM.command_line预期观察项包括完整版本、虚拟机设置、参数值和目标进程的启动命令,具体输出随环境变化。命令输出可能包含路径和参数中的敏感信息,归档前脱敏;jcmd 应匹配目标版本,并具备 attach(连接目标 JVM 进行诊断)权限。
2. GC 与对象布局:准确的时间线
GC(Garbage Collection,垃圾回收)负责回收不再需要的对象空间,收集器是执行这项工作的具体实现。不同收集器把工作分配给应用暂停阶段和并发阶段的方式不同,因此默认收集器变化可能改变停顿、CPU 消耗与内存余量需求。对象布局则描述对象在内存中的表示方式:对象头保存运行时管理信息,压缩引用用较紧凑的形式表示引用。布局变化可能影响内存占用,不能只根据源码字段估算。
下表区分“引入”“实验”“正式”“默认”和“移除”:正式特性不一定默认开启,默认模式变化也不代表所有部署都采用它。JEP(JDK Enhancement Proposal)是描述 JDK 改进目标与设计的提案,文末链接可用于查阅对应变更。
| 变更 | 版本与状态 | 迁移动作 |
|---|---|---|
| 元空间替代永久代 | 8 | 移除过时 PermGen 参数,为类元数据占用的本地内存留预算 |
| G1 成为默认 | 9,JEP 248 | 核对实际默认收集器,不能继续按 Parallel 的停顿机制解释 G1 |
| G1 并行 Full GC | 10,JEP 307 | 不是“G1 永远没有 Full GC” |
| CMS | 9 废弃,14 移除 | 识别旧 GC 参数并重新基线测试 |
| ZGC | 11 实验,15 正式 | 支持平台与历史限制按具体版本核验 |
| 分代 ZGC | 21 可选,23 默认,24 移除非分代 | 清理模式参数,不能复用旧指针图与周期分析 |
| 分代 Shenandoah | 24 实验(JEP 404),25 正式(JEP 521) | 正式不等于默认;发行版是否包含另核验 |
| 紧凑对象头 | 24 实验(JEP 450),25 正式但非默认(JEP 519) | 重新测量布局,不套传统 12 字节头 |
永久代(PermGen)和元空间都是理解类元数据存储变化时的重要概念;JDK 8 的元空间使用本地内存,需要在 Java 堆之外安排预算。Parallel、G1、CMS、ZGC 和 Shenandoah 是不同收集器,分代指按对象年龄等信息区分年轻代和老年代,以分别组织回收。Full GC 是完整回收路径,G1 仍可能进入该路径。紧凑对象头改变的是对象表示,不能直接套用传统布局中常见的 12 字节头估算。
GC 选择、压缩引用与对象头开关都属于实现配置,不能仅凭主版本确定。默认选择还要考虑发行版和运行平台。确认启动实际接受的参数,以及日志中的 collector/mode(收集器及模式);被忽略的参数不应视为启用成功。
3. 模块、字节码与依赖边界
3.1 JPMS 与强封装
JPMS(Java Platform Module System,Java 平台模块系统)把代码组织成模块,并定义模块依赖和包的访问边界。类和方法即使声明为 public,跨模块访问时也可能受包是否导出的限制;通过反射访问非公开成员,还要检查包是否开放。强封装就是让这些边界实际约束访问,避免应用依赖 JDK 的内部实现。
JDK 9 引入模块化运行时映像;标准运行时内容来自映像结构,不是从 jmods 目录逐个执行模块。jmods 主要供工具构建/链接使用,不能通过删除它判断运行时类是否可用。
JDK 17 的 JEP 403 加强内部 API 封装。依赖若通过深反射访问未开放的包,可能在执行该路径时失败。两个常见临时兼容参数的用途不同:
--add-exports:开放包中公开类型的访问,解决导出边界。--add-opens:开放深反射访问,解决非公开成员等反射边界。- 两者都不是永久兼容方案;按异常中的模块/包精确授权,优先升级依赖或替换内部 API。
sun.misc.Unsafe等关键内部 API 有特殊保留边界,不能说“所有 Unsafe 在 17 都不可用”,也不能认为其方法永久稳定。
JDK 11 移除部分 Java EE/CORBA 模块(JEP 320),即部分企业 Java API 和分布式对象通信相关模块不再由 JDK 提供。例如 JAXB 用于 Java 对象与 XML 的映射;应用原先依赖 JDK 提供它,升级后就需要显式引入依赖。还要检查命名空间、传递依赖和框架兼容,避免补上一个 jar 后又出现版本冲突。
3.2 构建成功不等于目标运行时兼容
以下为构建与依赖检查片段:使用支持 --release 17 的编译器,并准备业务源码 Application.java 与待检查的产物 app.jar。两条命令分别演示编译目标设置和依赖分析,不构成完整打包流程。
bash
javac --release 17 Application.java
jdeps --jdk-internals app.jar第一条命令生成面向 Java 17 的 class 文件;第二条使用 jdeps 分析产物对 JDK 内部 API 的依赖。预期观察项是编译结果和内部 API 依赖报告,报告内容取决于实际产物。静态分析不能替代反射、动态生成代码等运行路径的测试。--release 的约束只覆盖相应语言、字节码和平台 API,不证明第三方依赖也兼容;必须在目标运行时执行测试。JDK 8 的 javac 没有该选项。
preview(预览)特性是供特定版本试用、尚未形成稳定契约的能力,一般要求编译与运行使用相同主版本(major),并开启 --enable-preview。不能靠 --release 把新版 preview 带到旧 JVM。
依赖检查还要覆盖 ASM、CGLIB、Javassist 等字节码分析或生成库:它们需要理解目标 class 格式,框架能启动不代表生成代理时也兼容。APM(应用性能监控)Agent、使用 JVMTI(JVM 工具接口)的 Agent 和覆盖率工具同样需要检查。multi-release jar 是含有面向不同 Java 版本实现的归档包,新 JVM 可能选择不同的加载分支,因此应验证实际加载的实现。
动态代理、类加载隔离与框架生成代码的底层前置见 03、09;Spring 升级不是“JDK 能启动即可”,还要验证容器生命周期、反射和代理路径,AOT 路径见Spring 26。
4. 内存、容器和默认行为
容器通过 Linux 的 cgroup(控制组)限制并统计资源,v1/v2 是两套接口版本。JVM 对资源限制的识别会影响默认堆大小和部分线程数:如果升级后识别出的可用资源发生变化,即使启动参数没有改,运行配置也可能变化。quota 是 CPU 时间配额,cpuset 是允许使用的 CPU 集合;throttling 指用尽配额后被限制继续执行。
ergonomics 是 JVM 根据环境自动选择配置的机制。迁移时应对照实际生效值,而不是假定某个默认百分比适用于所有镜像。
| 项目 | 应确认的契约 | 不应使用的结论 |
|---|---|---|
| cgroup v1/v2 | vendor/update 对控制器、quota、cpuset 与内存限制的识别 | 所有 8u191 前都无容器支持,所有 17 都完全相同 |
| 堆 ergonomics | 实际 Xmx、RAMPercentage 与容器非堆预算 | MaxRAMPercentage 默认就是 75% |
| CPU | JVM 识别 CPU 数、实际 throttling、线程池变化 | major 升级一定让 CPU 数正确 |
| 紧凑字符串 | 9 起依内容选择 Latin-1/UTF-16 编码 | 所有字符串都减半 |
| 默认字符集 | 18 JEP 400 默认 UTF-8,仍有具体 API/控制台边界 | 设置 file.encoding 就覆盖所有网络/文件协议 |
| TLS/证书 | 实际 truststore、禁用算法、协议、主机名验证 | 所有 8u161 以前发行版 cacerts 都为空 |
| 时区/locale | tzdb 与区域规则、持久化格式 | UTF-8 变化会同步固定时区 |
TLS 是用于保护通信的协议;truststore 是验证对端证书时使用的信任库,cacerts 是 JDK 常见的证书库文件。JEP 319 是 OpenJDK 根证书计划,不能把此前 OpenJDK 源码材料的空证书库推广到所有 Oracle/其他发行版。升级可能改变受信任证书或禁用算法,测试应使用实际镜像和真实信任链,并覆盖失败路径。
Xmx 是 Java 堆上限,不是容器内存上限:元空间、代码缓存、直接内存、线程、JNI(Java 本地接口)相关分配与文件页都需预算。堆没有达到上限,容器仍可能因总内存超限而被终止,见 01、云原生 09;CPU 配额见云原生 10。
字符集决定字符与字节如何转换,时区决定时间如何映射为当地日期,两者是独立规则。紧凑字符串改变的是 String 的内部表示,不是网络或文件的编码约定。协议编解码应明确指定 Charset(字符集),并测试中文和异常字节;时间测试另行覆盖时区跨日、locale(区域设置)及 tzdb(时区规则数据库)的影响。
5. 并发模型:状态与限制分开看
5.1 常用语言特性与版本
版本迁移不只是换 GC。下表只列常用学习节点,不表示升级后必须立即改写业务,也不作为全部新增特性的清单:
| 特性 | 正式版本节点 | 基础用途与边界 |
|---|---|---|
| lambda、Stream、java.time | 8 | 表达函数、集合处理和日期时间;Stream 不等于并行执行,也不自动更快 |
局部变量类型推断 var | 10 | 从初始化表达式推断局部静态类型,不是动态类型变量 |
| switch 表达式 | 14 | 让分支产生值,与后来的 switch 模式匹配不是同一次变更 |
| 文本块 | 15 | 多行字符串表达,仍需要理解缩进、转义和外部协议编码 |
| record、instanceof 模式匹配 | 16 | record 简化数据载体;类型模式减少判断后的显式转换,不保证任意深层对象不可变 |
| switch 模式匹配 | 21 | 按类型等模式选择分支,需要理解匹配覆盖与 null 处理,不是仅换一种 if 写法 |
例如 record 的字段引用不能重新赋值,但其引用的 List 仍可能被修改;var 的变量在编译期已有确定类型,不能随后随意赋另一种不兼容类型。先理解语言契约,再考虑代码迁移,避免把“新语法”当作性能优化。
5.2 线程与上下文能力的版本边界
虚拟线程由 JVM 调度到载体线程上执行,载体线程是承载它的平台线程。虚拟线程在可卸载的阻塞点等待时,可以释放载体供其他任务执行,因而适合大量等待 I/O 的任务;CPU 密集计算仍受可用 CPU 限制。pinning(固定)指虚拟线程无法从载体卸载,若此时长时间阻塞,就会持续占用载体。
ThreadLocal 用于在线程内保存上下文;ScopedValue(作用域值)用于在限定作用域内绑定并读取值。Structured Concurrency(结构化并发)把关联子任务纳入共同的生命周期,便于协调完成、失败和取消。这些能力解决的问题不同,版本状态也应分别检查。
| 特性 | 到 JDK 25 的状态 | 使用边界 |
|---|---|---|
| 虚拟线程 | 21 正式(JEP 444) | 适合大量阻塞任务,不增加 CPU 算力 |
| monitor pinning 改进 | 24 JEP 491 | 大幅解除 synchronized 场景 pinning,不代表所有 native/foreign 路径都可卸载 |
| ScopedValue | 20 孵化,21~24 预览,25 正式(JEP 506) | 作用域绑定与 ThreadLocal 可变上下文不是完全等价 |
| Structured Concurrency | 25 仍预览(JEP 505) | API 迭代,按目标版本验证,不能当稳定跨版契约 |
先升级 JDK 并保持线程模型,再实验虚拟线程,才能区分版本变化和调度模型变化的影响。表中的 monitor 指 synchronized 使用的对象监视器;native/foreign 指本地或外部函数调用。不要为了旧版本 pinning 机械替换所有 synchronized,应定位真正发生的阻塞与载体占用。
不要池化虚拟线程:限制线程池大小与保护下游资源是两个不同问题。改用虚拟线程后,数据库连接数和外部服务容量并不会随之增加,仍需用入口或下游限流控制并发,并验证超时取消是否真正释放连接和任务。
完整代码与业务验证见并发 13,超时与取消的生命周期见并发 27。
6. 启动加速不等于编译成 native
启动时,JVM 需要加载类并完成相关准备工作。CDS(Class Data Sharing,类数据共享)把可复用的类数据保存到归档中,AppCDS 将应用类纳入归档,以减少重复工作;它们仍使用 JVM 执行应用。JDK 13 动态归档可在应用退出时生成。用完全相同的运行时和应用产物验证归档接受情况,不能把“存在 jsa 文件”视为启动收益证据。
以下命令以 JDK 13 引入的动态归档能力为例,要求准备可运行的 app.jar 并具有归档写入权限。第一条需运行到应用正常退出以生成 app.jsa,第二条再使用该归档启动:
bash
java -XX:ArchiveClassesAtExit=app.jsa -jar app.jar
java -XX:SharedArchiveFile=app.jsa -Xlog:cds=info -jar app.jar预期观察项是归档文件的生成,以及第二次启动的 CDS 日志是否显示归档被接受和使用;耗时收益需要另行对照测量。
AOT(Ahead-Of-Time,提前处理)需要结合处理对象理解。JDK 24 的 JEP 483 提供 AOT 类加载与链接,把相应工作前移,用于启动和预热优化;它不等于所有方法提前编译为机器码,也不等于生成 Native Image 本地可执行程序。比较时分别记录启动到 ready(服务可接收请求)和达到稳态性能的时间,不只比较进程创建时间。
CRaC(Coordinated Restore at Checkpoint,协调检查点恢复)通过保存进程状态并恢复来处理启动问题,其可用性取决于发行版和平台。checkpoint/restore(检查点保存与恢复)跨越了时间和运行环境:原有连接可能失效,凭证可能过期,所以需要处理连接、文件、随机状态、凭证和时钟,不能保证任何应用都毫秒恢复。Spring AOT/Native Image 的反射与构建约束见Spring 26。
7. 工程迁移:分阶段放行
放行是依据预先确定的测试和指标条件,决定是否进入下一阶段。灰度指先让少量真实流量进入新版本,再观察是否扩大范围;回滚则要恢复可用的旧运行环境,并确认它仍能处理当前数据。性能指标中的尾延迟关注较慢的那部分请求,不能只用平均耗时判断升级效果。
| 阶段 | 必要证据 | 阻断条件 |
|---|---|---|
| 资产盘点 | JVM 参数、依赖/Agent、镜像、内部 API、业务序列化格式 | 无法复现旧基线 |
| 构建与功能 | 目标 JVM 全路径测试;反射、插件、TLS、编码、报表字体 | 延迟加载或异常路径失败 |
| 资源基线 | 同 GC/配置对照,实际 CPU/内存、启动与预热 | OOM、throttling、内存峰值超预算 |
| 性能实验 | 相同负载、错误率、尾延迟、分配与停顿时间线 | 改善不能复现或无法归因 |
| 灰度 | 小流量真实依赖、稳定窗口与自动退回阈值 | 错误/延迟/资源超预设阈值 |
| 回滚演练 | 旧镜像可运行,新写入数据与旧代码兼容 | 无法读取新数据或回滚后仍保留外部副作用 |
如果同时升级 JDK、Spring、GC 和线程模型,出现延迟变化时就难以判断原因。应尽量拆分变更,每个变量保留对照;必须随 JDK 一起升级的依赖,也要记录其独立影响。性能对照保持工作负载、资源限制、预热过程和观察窗口一致,重复测量并检查波动,不把单次耗时当作容量结论。参数失效、模块异常、Agent 错误、TLS 失败先分类,不用广泛 --add-opens 掩盖所有异常。
灰度开始前就确定错误率、延迟和资源阈值,以及达到阈值后的退回动作,避免故障发生后临时决定。回滚演练还要检查新版本写入的数据、缓存或消息格式是否能被旧代码读取:退回镜像不会自动撤销外部状态变化,已经产生的副作用需要单独处理。
用 01 与 04 的完整小程序验证工具链与日志,再运行真实业务测试;小程序通过不证明数据库驱动、JNI、Spring 或 Agent 兼容。文中的 JDK 8/17 示例也不能替代 JDK 21/25、CDS/CRaC 或完整业务迁移验证。
8. 参考资料
- GC:248、307、363、377、439、474、490
- 新模式/布局:404、521、450、519
- 兼容与默认值:320、403、400、319
- 并发与启动:444、491、506、505、483
- 语言特性:286:var、361:switch 表达式、378:文本块、395:record、394:instanceof 模式匹配、441:switch 模式匹配
上述链接解释引入版本与设计,不替代所选发行商的补丁、支持周期和生产兼容性核验。
名词解释
| 名词 | 本文中的含义 |
|---|---|
| 发行版与 build | 供应商分发及具体构建身份;只记录主版本不能还原完整运行环境。 |
| LTS | 长期支持策略标签,具体支持期限和条件由发行商决定。 |
| release 目标 | 编译时约束语言、产物和对应平台 API 的目标,不保证第三方依赖兼容。 |
| 强封装 | 通过模块访问边界限制内部 API 或深反射,不等于删除所有公开 API。 |
| CDS / AppCDS | 类数据共享与应用类归档机制,不是把全部业务提前编译为本地程序。 |
| 预览特性 | 尚在特定版本中以预览方式提供的能力,需要对应启用条件与兼容验证。 |