截至2025年6月底，Spring 主要组件与 JDK 21 的兼容版本

以下是截至 2025 年，Spring 主要组件与 JDK 21 的兼容版本 的整理（基于官方支持策略和社区实践）：

---

核心框架兼容性

组件	最低支持 JDK 21 版本	2025 年推荐版本	关键特性支持
Spring Framework	6.1.0+	6.1.5+	完整支持虚拟线程（Loom）、Record 模式等
Spring Boot	3.2.0+	3.2.5+	首个原生支持 JDK 21 的 LTS 版本
Spring Cloud	2023.0.0+ (Leyton)	2023.0.7+	兼容 JDK 21 的响应式编程优化

---

关键子项目版本对照

组件	支持 JDK 21 的版本	2025 年稳定版本
Spring Data	2023.1.0+	2023.1.4+
Spring Security	6.2.0+	6.2.5+
Spring Batch	5.1.0+	5.1.4+
Spring Integration	6.2.0+	6.2.3+
Spring GraphQL	1.3.0+	1.3.2+
Spring Session	3.1.0+	3.1.4+
Spring AMQP	3.1.0+	3.1.3+
Spring Kafka	3.1.0+	3.1.5+
Spring REST Docs	3.1.0+	3.1.3+
Spring Modulith	1.1.0+	1.1.4+
Micrometer (监控)	1.12.0+	1.13.5+

---

JDK 21 专属特性支持

JDK 21 特性	Spring 支持版本	应用场景
虚拟线程 (Loom)	Spring Boot 3.2+	高并发服务（需配合 Tomcat 10.1.18+ 或 Jetty 12.0.5+）
序列化集合 (Sequenced Collections)	Spring Framework 6.1+	简化集合操作 API
ZGC 增强	全组件原生支持	低延迟垃圾回收
分代式 Shenandoah GC	全组件原生支持	大内存应用优化

---

强制依赖要求

1. Jakarta EE 10+
   必须使用命名空间 jakarta.*（如 jakarta.servlet:jakarta.servlet-api ≥6.0.0）
2. 第三方库最低版本

   库名	最低版本	说明
   Tomcat	10.1.18+	虚拟线程必需
   Jetty	12.0.5+	虚拟线程必需
   Hibernate	6.4.2+	JDK 21 字节码兼容性
   Lombok	1.18.30+	解决 JDK 21 反射限制
   Jackson	2.16.0+	支持 Record 模式序列化

---

构建配置示例

Maven 配置

<properties>
    <java.version>21</java.version>
    <spring-boot.version>3.2.5</spring-boot.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 虚拟线程支持（Tomcat 适配） -->
    <dependency>
        <groupId>org.apache.tomcat.embed</groupId>
        <artifactId>tomcat-embed-core</artifactId>
        <version>10.1.18</version>
    </dependency>
</dependencies>

Gradle 配置

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.5'
}
java {
    toolchain { languageVersion = JavaLanguageVersion.of(21) }
}
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // JDK 21 虚拟线程监控
    implementation 'io.micrometer:micrometer-core:1.13.5'
}

---

新特性实践指南

1. 启用虚拟线程

// 配置虚拟线程任务执行器
@Bean(TaskExecutionAutoConfiguration.APPLICATION_TASK_EXECUTOR_BEAN_NAME)
public AsyncTaskExecutor asyncTaskExecutor() {
    return new TaskExecutorAdapter(Executors.newVirtualThreadPerTaskExecutor());
}

// 在 Controller 中使用
@GetMapping("/concurrent")
public String handleRequest() {
    return Thread.currentThread().toString(); // 输出 VirtualThread
}

2. JDK 21 序列化集合优化

// 直接访问首尾元素（Sequenced Collections）
List<String> list = List.of("a", "b", "c");
String first = list.getFirst(); // JDK 21 新 API
String last = list.getLast();

---

升级风险与解决方案

问题	解决方案
Lombok 编译失败	升级至 ≥1.18.30 并添加 Javac 参数：-Djdk.traceVirtualThreadLocals=true
Hibernate 懒加载异常	升级至 ≥6.4.2 并启用配置：spring.jpa.properties.hibernate.bytecode.provider=bytebuddy
Tomcat 虚拟线程阻塞	确保使用 Tomcat ≥10.1.18 且禁用 server.tomcat.threads.max 配置
Jackson 解析 Record 失败	添加模块：jackson-datatype-jdk21

---

2025 年推荐技术栈

✅ **基础架构**  
- **JDK 21 (LTS)** + Spring Boot 3.2.5 + Spring Cloud 2023.0.7  
- 容器：Tomcat 10.1.18 (虚拟线程优化)  

✅ **数据层**  
- Spring Data JPA 2023.1.4 + Hibernate 6.4.2  
- Spring Data MongoDB 4.2.3 (支持 Vector 搜索)  

✅ **观测性**  
- Micrometer 1.13.5 + OpenTelemetry 1.34  
- 虚拟线程监控：`micrometer-tracing-virtual-threads`

✅ **安全**  
- Spring Security 6.2.5 + OAuth2 Resource Server (JWT 优化)

官方资源：

• Spring Boot 3.2 官方公告
• JDK 21 虚拟线程实践指南
  注：Spring Boot 3.2.x 是 2025 年企业级应用首选 LTS 版本，官方支持至 2026 年底。