作者：京东工业 韦付芝
一、背景与挑战
1.升级动因
◦Oracle 长期支持策略
◦现代特性需求：协程、模式匹配、ZGC 等
◦安全性与性能的需求
◦AI 新技术引入的版本要求
2.项目情况
◦100+项目并行升级的协同作战
◦多技术栈并存
◦持续集成体系的适配挑战
二、进度
三、主要问题域与解决方案
1. 依赖管理的"蝴蝶效应"
•sun.misc.BASE64Encoder 等内部 API 废弃 → 引发编译错误
•JAXB/JAX-WS 从 JDK 核心剥离 → XML 处理链断裂
•Lombok 与新版编译器兼容性问题（尤其 record 类型）
核心原因在于 JEP320 提案：https://openjdk.org/jeps/320
案例 1：历史 SDK 的编译陷阱
Compilation failure: Compilation failure:#14 4.173 [ERROR] 不再支持源选项 6。请使用 8 或更高版本。#14 4.173 [ERROR] 不再支持目标选项 6。请使用 8 或更高版本。
复制代码
<!-- 旧版本编译器配置导致构建失败 --><plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.5</version> <configuration> <source>1.6</source> <target>1.6</target> </configuration></plugin>
复制代码
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.13.0</version> <configuration> <release>8</release><!-- 统一使用release参数 --> </configuration></plugin>
复制代码
运行 HTML
案例 2：JAXB 的模块化剥离
javax.xml.bind.JAXBException:Implementation of JAXB-API has not been found
复制代码
<dependency> <groupId>org.glassfish.jaxb</groupId> <artifactId>jaxb-runtime</artifactId> <version>4.0.5</version></dependency>
复制代码
案例 3：Lombok 与新版编译器兼容性问题
java: java.lang.NoSuchFieldError
复制代码
<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version></dependency>
复制代码
案例 4：Resource 注解找不到
Caused by: java.lang.NoSuchMethodError: 'java.lang.String javax.annotation.Resource.lookup()'at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor$ResourceElement.<init>(CommonAnnotationBeanPostProcessor.java:664)at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor.lambda$buildResourceMetadata$0(CommonAnnotationBeanPostProcessor.java:395)at org.springframework.util.ReflectionUtils.doWithLocalFields(ReflectionUtils.java:669)at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor.buildResourceMetadata(CommonAnnotationBeanPostProcessor.java:377)at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor.findResourceMetadata(CommonAnnotationBeanPostProcessor.java:358)at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor.postProcessMergedBeanDefinition(CommonAnnotationBeanPostProcessor.java:306)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.applyMergedBeanDefinitionPostProcessors(AbstractAutowireCapableBeanFactory.java:1116)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:594)... 37 more
复制代码
<dependency> <groupId>jakarta.annotation</groupId> <artifactId>jakarta.annotation-api</artifactId> <version>1.3.5</version></dependency>
<dependency> <groupId>javax.annotation</groupId> <artifactId>javax.annotation-api</artifactId> <version>1.3.2</version></dependency>
复制代码
上述两个依赖代码基本一样，推荐使用该版本：
jakarta.annotation:jakarta.annotation-api。
2. 模块化的破与立
反射访问的模块墙
[ERROR] Unable to make field private int java.text.SimpleDateFormat.serialVersionOnStream accessible
复制代码
# 启动参数添加模块开放配置--add-opens java.base/java.text=ALL-UNNAMED--add-opens java.base/java.lang.reflect=ALL-UNNAMED
复制代码
完整模块开放配置模板
export JAVA_OPTS="-Djava.library.path=/usr/local/lib -server -Xmx4096m --add-opens java.base/sun.security.action=ALL-UNNAMED--add-opens java.base/java.lang=ALL-UNNAMED--add-opens java.base/java.math=ALL-UNNAMED--add-opens java.base/java.util=ALL-UNNAMED--add-opens java.base/sun.util.calendar=ALL-UNNAMED--add-opens java.base/java.util.concurrent=ALL-UNNAMED--add-opens java.base/java.util.concurrent.locks=ALL-UNNAMED--add-opens java.base/java.security=ALL-UNNAMED--add-opens java.base/jdk.internal.loader=ALL-UNNAMED--add-opens java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED--add-opens java.base/java.net=ALL-UNNAMED--add-opens java.base/sun.nio.ch=ALL-UNNAMED--add-opens java.management/java.lang.management=ALL-UNNAMED--add-opens jdk.management/com.sun.management.internal=ALL-UNNAMED--add-opens java.management/sun.management=ALL-UNNAMED--add-opens java.base/sun.security.action=ALL-UNNAMED--add-opens java.base/sun.net.util=ALL-UNNAMED--add-opens java.base/java.time=ALL-UNNAMED--add-opens java.base/java.lang.reflect=ALL-UNNAMED--add-opens java.base/java.io=ALL-UNNAMED"
复制代码
3. 语法层面的"时空穿越"
案例 1：Base64 编解码改造
// JDK8写法（已废弃）BASE64Encoder encoder =newBASE64Encoder();String encoded = encoder.encode(data);// JDK21规范写法Base64.Encoder encoder =Base64.getEncoder();String encoded = encoder.encodeToString(data);
复制代码
案例 2：日期序列化问题
Caused by:java.lang.reflect.InaccessibleObjectException: Unable to make field private int java.text.SimpleDateFormat.serialVersionOnStream accessible
复制代码
解决方案
1.使用 DateTimeFormatter 替代 SimpleDateFormat
2.或添加模块开放参数：--add-opens java.base/java.text=ALL-UNNAMED
4. 隐秘的"依赖战争"
注解包冲突典型案例
[ERROR] javax.annotation.Resource exists in both jsr250-api-1.0.jar and jakarta.annotation-api-1.3.5.jar
复制代码
<!-- 统一使用Jakarta标准 --><dependency> <groupId>jakarta.annotation</groupId> <artifactId>jakarta.annotation-api</artifactId> <version>2.1.1</version></dependency><!-- 排除旧版本依赖 --><exclusions> <exclusion> <groupId>javax.annotation</groupId> <artifactId>jsr250-api</artifactId> </exclusion></exclusions>
复制代码
5. 构建体系的改造
Maven 插件兼容性问题
[ERROR] The plugin org.apache.maven.plugins:maven-compiler-plugin:3.13.0 requires Maven version 3.6.3
复制代码
升级策略
1.升级 Maven 版本
2.统一插件版本
<build> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.13.0</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>3.4.0</version> </plugin> </plugins> </pluginManagement></build>
复制代码
四、最佳实践总结
1. 本地编译
第一步：在本地进行编译，提前识别出语法错误、版本冲突及不兼容问题。
主要有以下几种场景：
Base64：参照 【Base64 编解码改造】
lombok：升级版本
jsr250、jaxb-runtime、jakarta.annotation-api：参照 【注解包冲突典型案例】
maven-compiler-plugin：升级版本
maven-resources-plugin：升级版本
maven-war-plugin：升级版本
2. 行云构建
同【本地编译】
3. 行云部署
a、镜像不匹配：自定义镜像或者使用已申请的 jdk21 镜像
b、module 权限不够：参照【完整模块开放配置模板】
c、JDSecurity 加解密
所有数据库操作：important.properties 配置文件的处理方式
classpath:important.properties 使用 PropertyPlaceholderConfigurer 进行处理，不要用 JDSecurityPropertyFactoryBean。
<!-- <bean id ="secApplicationProperties" class="com.jd.security.configsec.spring.config.JDSecurityPropertyFactoryBean">--><!-- <property name="ignoreResourceNotFound" value="true" />--><!-- <property name="secLocation" value="classpath:important.properties"/>--><!-- </bean>-->
复制代码
4. 运行
a、序列化异常
jdk21 使用列表视图作为入参，导致 jsf 接口进行反序列化报错。报错代码如下：
List<String> subList = venderCodes.subList(i * batchSize, Math.min(venderCodes.size(), (i + 1) * batchSize));VendorQueryVo vendorQueryVo = new VendorQueryVo();vendorQueryVo.setVendorCodes(subList);// 该接口最多支持100条调用List<VendorVo> batchVendorNameByVendorCode = vendorBaseInfoService.getBatchVendorNameByVendorCode(vendorQueryVo, I18NParamFactory.getJDI18nParam());
复制代码
将 vendorQueryVo.setVendorCodes(subList) 修改为 vendorQueryVo.setVendorCodes(new ArrayList<>(subList)) 即可解决问题
b、线程上下文类找不到：使用多线程场景下尽可能使用显式指定线程池【默认情况下 不同运行环境的处理机制不同】
5. JVM 调优
垃圾回收调优
UseParallelGC、UseG1GC和UseZGC是 Java 虚拟机（JVM）中三种不同的垃圾回收器（Garbage Collector, GC），它们的设计目标和使用场景有所不同。以下是它们的区别：
•如果你的应用对吞吐量要求高，且可以接受较长的暂停时间，选择 UseParallelGC。
•如果你的应用对延迟有一定要求，且堆内存较大，选择 UseG1GC。
•如果你的应用对延迟极其敏感，且堆内存非常大，选择 UseZGC。
仅供参考，具体请按照实际情况来进行调整。
评论