1. 从JDK8到21的升级背景与挑战最近几年Java生态发生了翻天覆地的变化特别是JDK21作为最新的LTS版本带来了虚拟线程、模式匹配等革命性特性。我们团队负责的一个电商系统原本运行在JDK8SpringBoot 2.0.3的环境上为了利用这些新特性提升系统性能决定直接升级到JDK21。这个跨度将近10年的版本跳跃在实际操作中遇到了不少惊喜。首先需要明确的是JDK21要求的最低SpringBoot版本是3.0.x。这意味着我们不仅需要升级JDK还需要把SpringBoot从2.x跨越到3.x。这种大版本升级通常会带来API变更、配置调整和依赖兼容性问题。我们的系统使用了mybatis、redis和jasypt等常用组件这些都需要同步升级适配。提示在开始升级前建议先用mvn dependency:tree命令生成完整的依赖树这对后续排查兼容性问题非常有帮助。2. 环境准备与基础配置2.1 JDK21安装与配置从Oracle官网下载JDK21的安装包后我建议使用工具如jEnv或SDKMAN来管理多版本JDK。这样可以在不同项目间快速切换Java版本。安装完成后需要检查以下几个关键配置# 验证安装 java -version javac -version # 设置环境变量 export JAVA_HOME/path/to/jdk-21 export PATH$JAVA_HOME/bin:$PATH在Maven项目中pom.xml需要做如下调整properties java.version21/java.version maven.compiler.source21/maven.compiler.source maven.compiler.target21/maven.compiler.target /properties2.2 SpringBoot版本选择策略SpringBoot 3.x系列是支持JDK21的最低要求。经过测试我们最终选择了3.1.10这个相对稳定的版本。升级parent POM时要注意parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.1.10/version /parent这里有个坑需要注意SpringBoot 3.x默认使用Jakarta EE 9的命名空间这意味着所有javax.的导入都需要改为jakarta.。我们写了个简单的sed脚本批量处理了这个变更find . -name *.java -exec sed -i s/javax.servlet/jakarta.servlet/g {} \;3. 核心组件适配实战3.1 MyBatis升级与适配从mybatis-spring-boot-starter 1.x升级到3.x最大的变化是Spring框架依赖的升级。我们遇到了经典的NestedIOException找不到的问题解决方法很简单dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.2/version /dependency配置方面新版本对驼峰命名转换的配置位置发生了变化mybatis: configuration: map-underscore-to-camel-case: true3.2 Redis配置调整spring-boot-starter-data-redis的配置结构在3.x版本有了较大变化最明显的是配置前缀从spring.redis调整为了spring.data.redis。我们的生产配置最终调整为spring: data: redis: host: redis.example.com port: 6379 password: ${REDIS_PASSWORD} lettuce: pool: max-active: 16 max-idle: 8 min-idle: 43.3 Jasypt加密库适配jasypt-spring-boot-starter在3.x环境下需要特别注意版本兼容性。我们最终采用的配置方案是dependency groupIdcom.github.ulisesbocchio/groupId artifactIdjasypt-spring-boot-starter/artifactId version3.0.5/version /dependency加密配置的格式也发生了变化现在需要显式指定加密算法jasypt: encryptor: algorithm: PBEWITHHMACSHA512ANDAES_256 iv-generator-classname: org.jasypt.iv.RandomIvGenerator4. JDK21新特性实战应用4.1 虚拟线程性能优化JDK21最令人兴奋的特性莫过于虚拟线程了。我们在订单处理模块做了对比测试将传统的线程池改为虚拟线程后吞吐量提升了近3倍。关键改造代码如下try (var executor Executors.newVirtualThreadPerTaskExecutor()) { for (Order order : orders) { executor.submit(() - processOrder(order)); } }4.2 模式匹配简化代码新版switch表达式结合模式匹配让我们的业务代码简洁了不少。比如原来的订单状态判断if (order.getStatus() instanceof PaidStatus paid) { // 处理已支付订单 } else if (order.getStatus() instanceof ShippedStatus shipped) { // 处理已发货订单 }现在可以写成switch (order.getStatus()) { case PaidStatus paid - handlePaidOrder(paid); case ShippedStatus shipped - handleShippedOrder(shipped); default - handleUnknownStatus(); }4.3 序列化集合优化JDK21引入了新的集合API我们在缓存处理中大量使用了新的序列化集合方法ListString features List.of(vthread, pattern, serial); String json JsonUtils.toJson(features);5. 常见问题排查与解决5.1 Lombok兼容性问题升级后首先遇到的就是Lombok报错java: java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree$JCImport does not have member field com.sun.tools.javac.tree.JCTree qualid解决方法是将Lombok升级到至少1.18.30版本dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.30/version scopeprovided/scope /dependency5.2 日志框架冲突SLF4J在JDK21环境下可能会出现绑定冲突。我们通过排除冗余依赖解决了这个问题dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-logging/artifactId /exclusion /exclusions /dependency5.3 反射API变更JDK21加强了模块系统的限制导致一些依赖反射的库如某些JSON序列化工具无法正常工作。解决方法是在启动时添加JVM参数--add-opens java.base/java.langALL-UNNAMED --add-opens java.base/java.utilALL-UNNAMED6. 性能对比与调优建议6.1 升级前后性能指标我们在测试环境做了全面的性能对比指标JDK8SpringBoot2JDK21SpringBoot3提升幅度平均响应时间235ms178ms24%最大吞吐量1250 req/s2100 req/s68%内存占用1.2GB980MB18%6.2 JVM参数优化针对JDK21的特性我们调整了JVM参数-XX:UseZGC -XX:MaxRAMPercentage75 -XX:EnableJVMCI -XX:UseJVMCICompiler6.3 监控与诊断新的JFR(Java Flight Recorder)事件非常有用我们通过以下命令收集性能数据jcmd pid JFR.start nameprofile duration60s filenameprofile.jfr7. 渐进式升级策略对于大型项目我推荐采用渐进式升级策略先在测试环境搭建JDK21SpringBoot3的平行环境逐步迁移各个模块可以使用功能开关控制优先迁移非核心业务模块最后切换核心业务模块我们在实际升级过程中发现某些第三方库确实还没有适配JDK21。对于这种情况可以考虑以下几种解决方案联系库作者获取更新计划临时降级使用较旧的JDK版本运行特定服务考虑替换为已经支持JDK21的替代库整个升级过程我们花了大约三周时间其中大部分精力都花在解决各种依赖冲突和兼容性问题上。但最终的性能提升和代码简化效果确实值得这些投入。特别是在高并发场景下虚拟线程带来的性能提升非常明显而且不需要对现有代码做太多改造。