Spring Boot 2.x需JDK 8/11，3.x必须JDK 17；安装JDK 17后配置JAVA_HOME和PATH，验证java -version输出17.x，并在IDEA中确认JDK 17可选且pom.xml中java.version为17。
新手第一次装Spring Boot，最怕选错JDK导致项目创建失败、IDE报红、甚至卡在第一步——这完全没必要，因为版本错配是纯配置问题，不是你代码写得不对。
先看你的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（Win）、.pkg（Mac）或 .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 已正确握手。
