Spring Boot 3 要求 JDK 17 或更高版本,最低不支持 JDK 16 及以下;JDK 17 是基线版本,JDK 21 受支持且 Spring Boot 3.2+ 优化虚拟线程,非 LTS 版本(18/19/20)不建议生产使用。

Spring Boot 3 要求 JDK 17 或更高版本,最低不支持 JDK 16 及以下。
JDK 17 是 Spring Boot 3 的基线版本
Spring Boot 3.0 开始正式放弃对 JDK 8–16 的支持,JDK 17 是官方文档明确声明的最低要求。这是因为 Spring Boot 3 基于 Spring Framework 6,而后者依赖 JDK 17 的新特性(如密封类、新的 GC 接口、强封装的模块系统等)。
- 使用
JDK 17:完全兼容,推荐用于生产环境(LTS 版本,长期维护) - 使用
JDK 21:同样受官方支持,且 Spring Boot 3.2+ 对其有额外优化(如虚拟线程支持更完整) - 使用
JDK 18/19/20:技术上可运行,但属于非 LTS 版本,不建议用于生产 - 使用
JDK 16或更低:启动会直接失败,报错类似java.lang.UnsupportedClassVersionError或Unsupported major.minor version
构建工具中如何确认和指定 JDK 版本
Maven 和 Gradle 默认不会强制校验 JDK 版本,必须显式配置,否则可能在本地编译成功、CI 环境却失败。
- Maven:在
pom.xml中设置,并确保17 maven-compiler-plugin的和均为17 - Gradle:在
build.gradle中添加java { sourceCompatibility = JavaVersion.VERSION_17 } - IDE(如 IntelliJ):需检查 Project SDK 和 Project language level 是否均为 17+,否则即使 Maven 编译通过,编辑器也会标红或提示不兼容
常见错误现象与排查点
不是所有报错都会直说“JDK 版本太低”,尤其在混合环境(如旧 CI 镜像、Dockerfile 未更新)中容易误判。
立即学习“Java免费学习笔记(深入)”;
- 应用启动时报
java.lang.NoClassDefFoundError: java/lang/SecurityManager:JDK 17 移除了SecurityManager,Spring Boot 2.x 代码若未清理相关引用,升级后会出此错——本质是代码兼容性问题,但根因仍是 JDK 版本跃迁 - IDE 提示
@SpringBootApplication无法解析,或 Lombok 注解失效:大概率是 IDE 使用了老 JDK 编译项目,而非项目实际配置的 JDK - Docker 构建时用
openjdk:11-jre-slim镜像:镜像内 JDK 11,必然失败;应改用openjdk:17-jdk-slim或eclipse-temurin:17-jre-jammy
真正踩坑的地方往往不在“选哪个版本”,而在于构建链路中多个环节(本地 IDE、CI runner、Docker base image、K8s node JVM)是否全部统一到了 JDK 17+,漏掉任意一环都可能导致诡异的类加载或启动失败。










