Spring Boot与JDK版本兼容表：Spring Boot 2.x / 3.x / 4.x应该用哪个Java版本？

Spring Boot 2 应该用 JDK8、JDK11 还是 JDK17？
Spring Boot 3 为什么不能使用 JDK8？
Spring Boot 4 应该选择 JDK21 还是 JDK25？
Spring Boot 支持 JDK26 吗？
项目明明能编译，启动时为什么报 major version 错误？
升级 JDK 后 Maven、Gradle 或第三方依赖为什么又报错？

Spring Boot 2 = JDK8
Spring Boot 3 = JDK17
Spring Boot 4 = JDK21

Spring Boot 2.x / 3.x / 4.x 与 JDK 兼容关系
不同项目应该选择哪个 JDK
Spring Boot 对 Maven 和 Gradle 的版本要求
Spring Boot 2 升级 3 的主要变化
Spring Boot 3 升级 4 的主要变化
常见版本不兼容报错及排查方法

老项目：不要盲目升级，先保持现有可运行版本
Spring Boot 3 新项目：优先 JDK21
追求最大兼容性：使用 JDK17
Spring Boot 4 新项目：优先评估 JDK25
JDK26：先用于测试和兼容性验证

Spring Boot 3.0.13 兼容到 Java 21
Spring Boot 3.2.12 兼容到 Java 23
Spring Boot 3.4.13 兼容到 Java 24
Spring Boot 3.5.15 兼容到 Java 25

Spring Boot 3 支持所有 Java 17 以上版本

Spring Boot具体版本
+
JDK具体版本
+
Maven或Gradle版本
+
第三方依赖兼容性

Spring Boot 2.5.15：Java 8 ～ Java 18
Spring Boot 2.6.15：Java 8 ～ Java 19
Spring Boot 2.7.18：Java 8 ～ Java 21

长期稳定运行
依赖很多历史组件
使用旧版中间件或数据库驱动
暂时没有升级计划
只能运行在旧服务器环境

JDK安全更新
第三方依赖漏洞
Spring Boot具体维护版本
数据库驱动版本
TLS和证书兼容问题

保守选择：JDK11
较新环境：JDK17
准备迁移Spring Boot 3：先升级到JDK17

Lombok版本
Maven和Gradle版本
测试插件
Jacoco
ASM
Byte Buddy
数据库驱动
公司内部SDK

Spring Boot 3 + JDK8
Spring Boot 3 + JDK11

Spring Boot 3 + JDK17

维护历史项目：JDK17
当前新项目：JDK21
需要新LTS验证：Spring Boot 3.5 + JDK25

JDK17是Spring Boot 3最低基线，兼容性最保守
JDK21是成熟LTS，适合大多数新项目
JDK25是最新LTS，但需要更高版本Spring Boot和依赖验证

Spring Boot 3.5.15：兼容到 Java 25
Spring Boot 4.0.7：兼容到 Java 26
Spring Boot 4.1.0：兼容到 Java 26

JDK25：最新LTS
JDK21：上一个LTS
JDK26：最新Java SE版本

Spring Boot 4 + JDK21

第三方依赖较多
公司基础设施暂未升级
希望降低迁移风险
需要先验证Spring Boot 4本身

Spring Boot 4 + JDK25

新项目
长期维护项目
团队愿意完整测试依赖
希望使用最新LTS

Spring Boot 4 + JDK26

测试环境
框架兼容验证
Java新特性体验
非关键生产服务试点

运行在Java 21上，至少需要Gradle 8.5
运行在Java 24上，至少需要Gradle 8.14
运行在Java 25上，至少需要Gradle 9.1
运行在Java 26上，至少需要Gradle 9.4

java -version
javac -version

mvn -version

Java version
Java home

./gradlew --version

gradlew.bat --version

Gradle
Launcher JVM
Daemon JVM

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.15</version>
</parent>

plugins {
    id 'org.springframework.boot' version '3.5.15'
}

:: Spring Boot :: (v3.5.15)

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.18</version>
</parent>

<properties>
    <java.version>17</java.version>
</properties>

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.15</version>
</parent>

<properties>
    <java.version>21</java.version>
</properties>

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.1.0</version>
</parent>

<properties>
    <java.version>25</java.version>
</properties>

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

Gradle运行使用的JDK
项目编译使用的Toolchain JDK
IDEA中的Gradle JVM
项目中的Project SDK

JDK升级到17或更高
Spring Boot先升级到2.7.x
Spring Security版本
Spring Cloud版本
数据库驱动
第三方Starter
配置属性变更
废弃API
javax迁移到jakarta

import javax.servlet.http.HttpServletRequest;
import javax.persistence.Entity;
import javax.validation.Valid;

import jakarta.servlet.http.HttpServletRequest;
import jakarta.persistence.Entity;
import jakarta.validation.Valid;

Spring Framework 7兼容性
Spring Security版本
Spring Cloud版本映射
Jakarta EE 11相关变化
Servlet容器版本
自定义Starter
自动配置类
配置属性变更
测试框架
GraalVM版本
Gradle Wrapper版本

<version>4.1.0</version>

error: invalid source release: 17

项目要求Java 17编译
但Maven或IDEA实际使用的JDK低于17

java -version
javac -version
mvn -version

Unsupported class file major version

当前运行或构建工具不能识别更高版本JDK生成的class文件

No compiler is provided in this environment.
Perhaps you are running on a JRE rather than a JDK?

package javax.servlet does not exist
package javax.persistence does not exist

Unsupported Java
Could not open cp_settings generic class cache
Unsupported class file major version

./gradlew --version

Project SDK
Module SDK
Maven Runner JRE
Gradle JVM
Run Configuration JRE

Project SDK = 项目JDK
Module SDK = Project SDK
Maven Runner JRE = Project JDK
Gradle JVM = 项目兼容的JDK
Run Configuration JRE = Project SDK

1. 确认当前Spring Boot具体版本
2. 查看该版本官方Java兼容范围
3. 确认目标JDK是否为LTS
4. 检查Maven或Gradle版本
5. 检查Gradle Wrapper能否运行在目标JDK
6. 检查Spring Cloud版本映射
7. 检查数据库驱动
8. 检查Lombok、ASM、Byte Buddy、Jacoco
9. 检查公司内部Starter和SDK
10. 检查javax到jakarta迁移
11. 在测试环境运行完整自动化测试
12. 检查Docker和CI/CD中的JDK
13. 检查生产服务器实际java -version
14. 准备回滚方案

Spring Boot：按现有版本
JDK：按现有验证版本
建议：先升级依赖补丁，再规划大版本迁移

Spring Boot：2.7.18
JDK：11或17
建议：为升级Spring Boot 3做准备

Spring Boot：3.5.x
JDK：21
Maven：3.6.3+
Gradle：按项目实际选择受支持版本

Spring Boot：4.1.x
JDK：25
建议：提前验证第三方Starter、Spring Cloud和监控组件

Spring Boot：4.1.x
JDK：26
建议：用于测试和新特性验证，不要未经测试直接替换生产环境

老项目或保守环境：JDK17
新项目：JDK21
Spring Boot 3.5并愿意充分测试：可评估JDK25

本机JAVA_HOME
mvn -version使用的JDK
IDEA Maven Runner JRE
CI/CD构建JDK
Docker基础镜像
服务器运行JDK

Spring Boot 2.x：
最低通常是JDK8，但最高支持版本取决于具体分支

Spring Boot 3.x：
最低JDK17，不同分支最高支持Java 21～25

Spring Boot 4.x：
最低JDK17，当前4.0和4.1兼容到JDK26

老Spring Boot 2项目：保持现有验证版本，逐步规划升级
Spring Boot 3新项目：优先JDK21
Spring Boot 4新项目：优先评估JDK25
追求最大兼容性：JDK17或JDK21
测试最新功能：Spring Boot 4 + JDK26

Maven
Gradle
Spring Cloud
数据库驱动
Lombok
测试插件
字节码处理工具
Docker
CI/CD
生产服务器

2026-06-26：
- 创建Spring Boot与JDK版本兼容表
- 增加Spring Boot 2.5、2.6、2.7兼容范围
- 增加Spring Boot 3.0至3.5兼容范围
- 增加Spring Boot 4.0、4.1兼容范围
- 增加Maven与Gradle版本要求
- 增加Spring Boot 2升级3注意事项
- 增加Spring Boot 3升级4注意事项
- 增加常见JDK版本不兼容报错排查