先确定你的 Spring Boot 大版本
Spring Boot 2.x 与 3.x 对 JDK 版本的要求截然不同，不能混用。如果你尚未确定版本，需要先明确方向：
方法一：保守入门，选择 Spring Boot 2.7.x → 【必须使用 JDK 8 或 JDK 11】。这两个版本均为 LTS 长期支持版，教程资源最丰富、报错最少，许多公司老项目也在使用。你只需照着 B 站或知乎上的任意一个“Spring Boot 入门”视频操作，99% 可以一次成功。
方法二：直接上手新版本，选择 Spring Boot 3.2.x 或 3.3.x → 【必须使用 JDK 17】。这是当前生产环境最稳定的组合，Spring 最新 CI 每天都会在 JDK 17 上运行全量测试，甚至虚拟线程、GraalVM 原生镜像也已默认适配。不必听信“JDK 21 更香”，对于新手而言，JDK 17 的文档最全、报错提示最友好、IDEA 插件兼容性最好。
⚠️ 注意：Spring Boot 3.x 在 JDK 8 或 JDK 11 下根本无法启动，会直接抛出 java.lang.UnsupportedClassVersionError —— 这并非配置问题，而是字节码版本硬不匹配，任何配置修改都无法挽救。
下载与安装实操指南（以 JDK 17 为例）
第一步：前往 Adoptium Temurin 官方（https://adoptium.net）下载，不要到 Oracle 官网填表注册——Temurin 是 Eclipse 基金会维护的免费、开源、生产就绪的 OpenJDK 发行版，国内访问速度快，无登录门槛。
第二步：选择「JDK 17 LTS」→ 根据操作系统选择对应版本（Windows x64 / macOS ARM64 / Linux x64）→ 下载对应的 .msi（Windows）、.pkg（macOS）或 .tar.gz（Linux）文件。
第三步：双击安装（Windows/macOS）或解压后配置（Linux），安装路径中不要包含中文和空格，例如 C:\dev\jdk-17.0.2 或 /opt/jdk-17.0.2。
第四步：配置 JAVA_HOME 环境变量，值为 JDK 安装根目录（不含 bin）；然后在 Path 中追加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）。
第五步：打开新终端，执行 java -version，输出应为 java version "17.0.2" 或类似，且没有 warning 提示 “could not determine java version”。如果显示 “command not found”，说明 PATH 未生效，请重启终端或重新登录系统。
验证能否成功运行 Spring Boot
使用 IDEA 创建新项目时，在 New Project → Spring Initializr 页面，左侧 JDK 下拉框中必须能看到你刚安装的 JDK 17；右侧 Spring Boot 版本会自动匹配为 3.2.x 或 3.3.x —— 如果下拉列表中只有 2.7.x，说明 IDEA 未识别到 JDK 17，请返回检查 JAVA_HOME 并重启 IDE。
创建完项目后，打开 pom.xml，确认存在 clean compile，若不报错即表示 JDK 与 Spring Boot 已正确握手。
