从JDK8到21：SpringBoot核心组件适配实战与性能优化
1. 从JDK8到21的升级背景与挑战
最近几年Java生态发生了翻天覆地的变化，特别是JDK21作为最新的LTS版本，带来了虚拟线程、模式匹配等革命性特性。我们团队负责的一个电商系统原本运行在JDK8+SpringBoot 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.version>21</java.version> <maven.compiler.source>21</maven.compiler.source> <maven.compiler.target>21</maven.compiler.target> </properties>2.2 SpringBoot版本选择策略
SpringBoot 3.x系列是支持JDK21的最低要求。经过测试，我们最终选择了3.1.10这个相对稳定的版本。升级parent POM时要注意：
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.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> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.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> <groupId>com.github.ulisesbocchio</groupId> <artifactId>jasypt-spring-boot-starter</artifactId> <version>3.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，我们在缓存处理中大量使用了新的序列化集合方法：
List<String> 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> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version> <scope>provided</scope> </dependency>5.2 日志框架冲突
SLF4J在JDK21环境下可能会出现绑定冲突。我们通过排除冗余依赖解决了这个问题：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> </exclusion> </exclusions> </dependency>5.3 反射API变更
JDK21加强了模块系统的限制，导致一些依赖反射的库（如某些JSON序列化工具）无法正常工作。解决方法是在启动时添加JVM参数：
--add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED6. 性能对比与调优建议
6.1 升级前后性能指标
我们在测试环境做了全面的性能对比：
| 指标 | JDK8+SpringBoot2 | JDK21+SpringBoot3 | 提升幅度 |
|---|---|---|---|
| 平均响应时间 | 235ms | 178ms | 24% |
| 最大吞吐量 | 1250 req/s | 2100 req/s | 68% |
| 内存占用 | 1.2GB | 980MB | 18% |
6.2 JVM参数优化
针对JDK21的特性，我们调整了JVM参数：
-XX:+UseZGC -XX:MaxRAMPercentage=75 -XX:+EnableJVMCI -XX:+UseJVMCICompiler6.3 监控与诊断
新的JFR(Java Flight Recorder)事件非常有用，我们通过以下命令收集性能数据：
jcmd <pid> JFR.start name=profile duration=60s filename=profile.jfr7. 渐进式升级策略
对于大型项目，我推荐采用渐进式升级策略：
- 先在测试环境搭建JDK21+SpringBoot3的平行环境
- 逐步迁移各个模块，可以使用功能开关控制
- 优先迁移非核心业务模块
- 最后切换核心业务模块
我们在实际升级过程中，发现某些第三方库确实还没有适配JDK21。对于这种情况，可以考虑以下几种解决方案：
- 联系库作者获取更新计划
- 临时降级使用较旧的JDK版本运行特定服务
- 考虑替换为已经支持JDK21的替代库
整个升级过程我们花了大约三周时间，其中大部分精力都花在解决各种依赖冲突和兼容性问题上。但最终的性能提升和代码简化效果确实值得这些投入。特别是在高并发场景下，虚拟线程带来的性能提升非常明显，而且不需要对现有代码做太多改造。