项目JDK升级需优先确认框架依赖的最低版本要求，如Spring Boot 3.x强制JDK 17+，Shiro/Struts2则受限于JDK 8；生产环境应选用LTS版本（JDK 17/21），避免短期版本（JDK 22/23）；本地、CI/CD及IDE必须统一JDK版本与编译参数，并验证JVM选项兼容性。
看清楚项目依赖的框架最低 JDK 要求
很多团队卡在升级 JDK 上，不是因为新版本不好，而是 Spring Boot、MyBatis 或内部 SDK 明确声明了最低支持版本。比如 Spring Boot 3.x 强制要求 JDK 17+，而 Spring Boot 2.7.x 最高只兼容到 JDK 21（部分补丁版对 JDK 21 支持不完整）。查清依赖项的官方文档比盲目追新更重要。
- 运行
mvn dependency:tree | grep spring-boot确认 Spring Boot 版本，再查其Supported JDK Versions表 - 老项目用
Shiro或Struts2，大概率得停在 JDK 8 —— 它们早已停止维护，JDK 11 的模块系统和 TLS 1.3 默认启用会直接触发类加载失败或握手异常 - 如果用了
javax.*包（如javax.xml.bind），JDK 9+ 已移除，需显式加jakarta.xml.bind:jakarta.xml.bind-api依赖
生产环境优先选 LTS 版本而非最新 GA 版
JDK 17 和 JDK 21 是当前主流 LTS（长期支持）版本，OpenJDK 社区和各大厂商（Eclipse Temurin、Amazon Corretto、Azul Zulu）都会持续提供安全更新至少 8 年。而 JDK 22、23 是短期版本，6 个月后即废弃，不适合上生产。
- 阿里、腾讯、字节等大厂线上服务普遍锁定在
JDK 17，部分新业务线开始灰度JDK 21 -
JDK 21相比JDK 17新增了虚拟线程（VirtualThread）、sequenced collectionsAPI、更稳定的Pattern Matching for switch，但这些特性需要代码主动适配，不是开箱即用 - 别被 “JDK 21 性能提升 10%” 这类标题误导——实际吞吐提升取决于 GC 策略、堆大小、应用类型；小对象多的服务用
ZGC+ JDK 21 可能有收益，IO 密集型反而可能因虚拟线程调度开销略升
本地开发与 CI/CD 环境必须统一 JDK 版本
开发者用 JDK 21 写了 record 带 sealed 修饰符，CI 流水线却跑在 JDK 17 上，编译直接报错：error: illegal combination of modifiers: sealed and final。这种不一致比性能问题更常导致构建失败。
- 在
pom.xml中固定maven-compiler-plugin的source和target，例如设为17，可防本地误用高版本语法 - CI 脚本里显式指定 JDK：GitHub Actions 用
actions/setup-java@v4指定java-version: '17'；Jenkins 则在节点配置中绑定具体 JDK Home - IDE（IntelliJ / Eclipse）的 Project SDK 和 Language Level 必须手动核对，IDE 自动检测常出错，尤其在多 JDK 共存时
注意 JVM 参数在不同 JDK 间的兼容性断裂
有些参数在 JDK 17 可用，到了 JDK 21 就被移除或改名，比如 -XX:+UseStringDeduplication 在 JDK 21 中已无效（G1 默认开启），而 -XX:+UnlockExperimentalVMOptions 在 JDK 17 后逐步淘汰。
立即学习“Java免费学习笔记（深入）”；
- GC 参数变动最频繁：
-XX:+UseG1GC仍是通用选项，但-XX:MaxGCPauseMillis的实际效果在 JDK 21 的 G1 中更保守，建议配合-Xlog:gc*观察真实停顿 - JDK 21 默认启用
ZGC的并发类卸载（-XX:+ZConcurrentLowMemoryPressure），但某些监控 Agent（如旧版 SkyWalking）尚未适配，会导致OutOfMemoryError: Metaspace - 所有自定义 JVM 参数务必在目标 JDK 版本下执行
java -XX:+PrintFlagsFinal -version | grep YourOption验证是否存在
版本选型真正难的不是“哪个更新”，而是厘清“谁在约束你”——框架、中间件、运维规范、遗留代码、第三方 SDK，甚至某个用了 sun.misc.Unsafe 的私有工具类。一旦忽略其中一环，升级就变成救火现场。
