Spring Initializr 生成的项目在执行 ./gradlew bootRun 时出现类路径解析失败（如无法下载 spring-boot-gradle-plugin），通常源于 JDK 环境配置错误——JAVA_HOME 指向了 JRE 而非完整 JDK。
spring initializr 生成的项目在执行 `./gradlew bootrun` 时出现类路径解析失败（如无法下载 `spring-boot-gradle-plugin`），通常源于 jdk 环境配置错误——`java_home` 指向了 jre 而非完整 jdk。
当你使用 Spring Initializr（https://www.php.cn/link/4ac20f72e05b86b3dc759608b60f5d67）生成基于 Gradle 的 Spring Boot 3.1.1 项目后，执行 ./gradlew bootRun 报错：
> Could not resolve all files for configuration ':classpath'. > Could not resolve org.springframework.boot:spring-boot-gradle-plugin:3.1.1.
同时 Eclipse 中所有 org.springframework.* 包均报红（如 import org.springframework.boot.SpringApplication; 无法解析），这并非依赖未下载或网络问题，而是一个典型的底层环境陷阱。
? 根本原因：JAVA_HOME 指向 JRE，而非 JDK
Gradle（尤其是 Spring Boot 3.x 所需的 Gradle 8+）在构建过程中不仅需要 Java 运行时（JRE），更需要完整的 JDK —— 因为它要调用 javac 编译源码、执行注解处理器（如 @SpringBootApplication 的元数据处理）、以及加载 Gradle 插件的编译期逻辑。若 JAVA_HOME 指向仅含 java 命令的 JRE 目录（例如 /Library/Java/Home/jre 或 /usr/lib/jvm/java-17-openjdk-amd64/jre），则 javac 不可用，Gradle 将无法初始化构建环境，进而导致插件仓库解析失败、依赖无法下载、IDE 无法识别 Spring 类型。
✅ 验证方式（终端执行）：
echo $JAVA_HOME ls -l $JAVA_HOME/bin/javac # 应返回有效路径；若提示 "No such file or directory"，即为 JRE java -version javac -version # 必须可执行且版本号与 java -version 一致
✅ 正确配置 JDK 环境（macOS 示例）
-
确认已安装 JDK 17+（推荐 Eclipse Temurin 或 Oracle 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）：echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc source ~/.zshrc
-
验证生效：
echo $JAVA_HOME # 应输出类似 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home javac -version # 输出 javac 17.x.x
? 补充建议（提升开发体验）
Eclipse 配置同步：
进入Eclipse → Preferences → Java → Installed JREs，移除所有 JRE 条目，仅添加你刚配置的 JDK（路径同$JAVA_HOME），并设为默认。
再右键项目 →Gradle → Refresh Gradle Project，Eclipse 将自动下载依赖并解析 Spring 类型。避免手动创建 Java Project：
不要通过 “New → Java Project” 导入demo文件夹。正确做法是：
→File → Import → Gradle → Existing Gradle Project→ 选择demo文件夹 → 完成导入。
这样 Eclipse 才能识别build.gradle并启用 Gradle 构建生命周期。-
首次构建加速（可选）：
若网络较慢，可在gradle.properties中添加阿里云镜像（位于~/.gradle/）：systemProp.gradle.jvmargs=-Xmx4g mavenCentralUrl=https://maven.aliyun.com/repository/public
✅ 总结
Spring Boot 项目构建失败，90% 的“依赖找不到”表象背后，实则是 JDK 环境缺失这一基础前提。JAVA_HOME 必须指向包含 bin/javac 的完整 JDK，而非精简版 JRE。完成校验与配置后，重新运行 ./gradlew clean bootRun，服务将成功启动于 http://localhost:8080，Eclipse 中所有 Spring 类型也将正常解析——这才是 Spring Quickstart 的真正起点。
