JDK从8升级到21的问题集

摘要：Compilation failure: Compilation failure:#14 4.173 [ERROR] 不再支持源选项 6。请使用 8 或更高版本。#14 4.173 [ERROR] 不再支持目标选项 6。请使用 8 或更高版本。

1.升级动因

◦Oracle长期支持策略

◦现代特性需求：协程、模式匹配、ZGC等

◦安全性与性能的需求

◦AI新技术引入的版本要求

2.项目情况

◦100+项目并行升级的协同作战

◦多技术栈并存

◦持续集成体系的适配挑战

应用总数已完成应用下线待升级100+731310+

•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 或更高版本。org.apache.Maven.pluginsmaven-compiler-plugin3.51.6org.apache.maven.plugins3.13.08

运行 HTML

案例2：JAXB的模块化剥离

javax.xml.bind.JAXBException:Implementation of JAXB-API has not been foundorg.glassfish.jaxbjaxb-runtime4.0.5

案例3：Lombok与新版编译器兼容性问题

org.projectlomboklombok1.18.30Caused by: java.lang.NoSuchMethodError: 'java.lang.String javax.annotation.Resource.lookup'at org.springframework.context.annotation.CommonAnnotationBeanPostProcessor$ResourceElement.(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 morejakarta.annotationjakarta.annotation-api1.3.5javax.annotationjavax.annotation-api1.3.2

上述两个依赖代码基本一样，推荐使用该版本：

jakarta.annotation:jakarta.annotation-api。

反射访问的模块墙

[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"

案例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

注解包冲突典型案例

[ERROR] javax.annotation.Resource exists in both jsr250-api-1.0.jar and jakarta.annotation-api-1.3.5.jarjakarta.annotationjakarta.annotation-api2.1.1javax.annotationjsr250-api

Maven插件兼容性问题

[ERROR] The plugin org.apache.maven.plugins:maven-compiler-plugin:3.13.0 requires Maven version 3.6.3

升级策略

1.升级Maven版本

2.统一插件版本

org.apache.maven.pluginsmaven-compiler-plugin3.13.0

maven-war-plugin3.4.0

第一步：在本地进行编译，提前识别出语法错误、版本冲突及不兼容问题。

主要有以下几种场景：

Base64：参照 【Base64编解码改造】

lombok：升级版本

jsr250、jaxb-runtime、jakarta.annotation-api：参照 【注解包冲突典型案例】

maven-compiler-plugin：升级版本

maven-resources-plugin：升级版本

maven-war-plugin：升级版本

a、镜像不匹配：自定义镜像或者使用已申请的jdk21镜像

b、module权限不够：参照【完整模块开放配置模板】

c、JDSecurity加解密

所有数据库操作：important.properties配置文件的处理方式

classpath:important.properties 使用PropertyPlaceholderConfigurer进行处理，不要用JDSecurityPropertyFactoryBean。

a、序列化异常

jdk21使用列表视图作为入参，导致jsf接口进行反序列化报错。报错代码如下：

ListsubList = venderCodes.subList(i * batchSize, Math.min(venderCodes.size, (i + 1) * batchSize));VendorQueryVo vendorQueryVo = new VendorQueryVo;vendorQueryVo.setVendorCodes(subList);// 该接口最多支持100条调用ListbatchVendorNameByVendorCode = vendorBaseInfoService.getBatchVendorNameByVendorCode(vendorQueryVo, I18NParamFactory.getJDI18nParam);

将 vendorQueryVo.setVendorCodes(subList) 修改为vendorQueryVo.setVendorCodes(new ArrayList(subList)) 即可解决问题

b、线程上下文类找不到：使用多线程场景下尽可能使用显式指定线程池【默认情况下不同运行环境的处理机制不同】

垃圾回收调优

UseParallelGC、UseG1GC和UseZGC是 Java 虚拟机（JVM）中三种不同的垃圾回收器（Garbage Collector, GC），它们的设计目标和使用场景有所不同。以下是它们的区别：

特性UseParallelGCUseG1GCUseZGC设计目标高吞吐量平衡吞吐量和延迟极低延迟暂停时间较长较短极短适用堆大小中小堆（几 GB 到几十 GB）大堆（几十 GB 到几百 GB）超大堆（TB 级别）CPU 消耗中等中等较高适用场景批处理、计算密集型任务对延迟有一定要求的应用对延迟极其敏感的应用

•如果你的应用对吞吐量要求高，且可以接受较长的暂停时间，选择UseParallelGC。

•如果你的应用对延迟有一定要求，且堆内存较大，选择UseG1GC。

•如果你的应用对延迟极其敏感，且堆内存非常大，选择UseZGC。

仅供参考，具体请按照实际情况来进行调整。

RSS内存有问题的应用可以尝试使用jemalloc方式替换linux默认的glibc内存分配方式。

问题现象：启动后RSS内存使用率很快达到90%以上，甚至接近于100%。

使用方式：启动脚本增加

if [ ! -f "/usr/local/lib/libjemalloc.so.2" ]; then sudo wget -O /usr/local/lib/libjemalloc.so.2 http://storage.jd.local/ste/jemalloc/x86/5.3.0/libjemalloc.so.2 fi export LD_PRELOAD=$LD_PRELOAD:/usr/local/lib/libjemalloc.so.2

使用效果：