Spring Initializr 生成的项目在执行 ./gradlew bootRun 时出现 classpath 解析失败，核心原因是 $JAVA_HOME 指向了 JRE 而非 JDK，导致 Gradle 缺少编译器（javac）和完整 Java 构建工具链。
spring initializr 生成的项目在执行 `./gradlew bootrun` 时出现 classpath 解析失败，核心原因是 `$java_home` 指向了 jre 而非 jdk，导致 gradle 缺少编译器（`javac`）和完整 java 构建工具链。
当你使用 Spring Initializr（https://www.php.cn/link/4ac20f72e05b86b3dc759608b60f5d67）生成基于 Gradle 的 Spring Boot 3.1.1 + Java 17 的项目后，执行 ./gradlew bootRun 报错：
> Could not resolve all files for configuration ':classpath'. > Could not resolve org.springframework.boot:spring-boot-gradle-plugin:3.1.1.
该错误表面是插件下载失败，但根本原因往往并非网络或仓库配置问题，而是 Gradle 启动阶段无法正确初始化 JVM 工具链——尤其当 $JAVA_HOME 指向 JRE（Java Runtime Environment）时。
JRE 仅包含运行时类库（如 rt.jar）和 java 命令，不包含 javac、jdeps、jlink 等开发工具，也不提供 tools.jar（已自 JDK 9 废弃，但构建系统仍依赖 JDK 完整结构）。而 Gradle（尤其是 8.x+ 版本）在解析 spring-boot-gradle-plugin 时，会尝试加载并验证插件的编译期元数据，此过程依赖 JDK 提供的标准注解处理器和反射能力。若 $JAVA_HOME 指向 JRE，Gradle 将静默降级或抛出误导性依赖解析异常。
✅ 验证与修复步骤如下：
-
检查当前 JAVA_HOME：
echo $JAVA_HOME ls -l $JAVA_HOME
若输出路径含
jre（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/jre）或Contents/Home/jre，即为 JRE。 -
确认可用 JDK：
/usr/libexec/java_home -V # 示例输出： # 17.0.8 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 17" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
-
正确设置 JAVA_HOME（推荐方式）：
在~/.zshrc（macOS Catalina+ 默认 Shell）中添加：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
然后重载配置：
source ~/.zshrc -
验证 JDK 可用性：
java -version # 应显示 JDK 版本（含 "Java(TM) SE Runtime Environment" + "Java HotSpot(TM)"） javac -version # 必须能成功输出，否则仍为 JRE
-
清理并重试构建：
./gradlew --stop # 停止旧守护进程 rm -rf .gradle build # 清理缓存（可选） ./gradlew bootRun # 重新启动
? 额外注意事项：
- Eclipse 中导入 Gradle 项目前，请确保 Preferences → Java → Installed JREs 已注册正确的 JDK（而非 JRE），并在项目属性中指定其为 Execution Environment；
- Spring Boot 3.x 要求 JDK 17+（官方支持 LTS），且必须为 JDK，不接受 JRE；
- 若使用 IDE 内置终端，需重启 IDE 或重新打开终端以加载更新后的环境变量；
- 不建议手动修改
gradle/wrapper/gradle-wrapper.properties中的distributionUrl来规避问题——这治标不治本，且可能引入版本兼容风险。
修复 $JAVA_HOME 指向 JDK 后，spring-boot-gradle-plugin 将正常解析，IDE 中的 org.springframework.boot 和 org.springframework.web 包也能被正确索引和导入。这是 Spring 新手最易忽略却高频发生的环境配置陷阱。
