Spring Initializr 生成的项目在执行 ./gradlew bootRun 时出现类路径解析失败（如无法找到 spring-boot-gradle-plugin），通常源于 JDK 环境配置错误——JAVA_HOME 指向了 JRE 而非完整 JDK，导致 Gradle 编译器缺失。
spring initializr 生成的项目在执行 `./gradlew bootrun` 时出现类路径解析失败（如无法找到 `spring-boot-gradle-plugin`），通常源于 jdk 环境配置错误——`java_home` 指向了 jre 而非完整 jdk，导致 gradle 编译器缺失。
当你使用 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 中大量 Spring 相关导入（如 org.springframework.boot.SpringApplication、org.springframework.web.bind.annotation.*）显示为 unresolved，这并非依赖未下载或网络问题，而是 Gradle 在初始化构建环境时已因底层 Java 工具链缺失而提前失败。
根本原因在于：$JAVA_HOME 环境变量指向了一个 JRE（Java Runtime Environment），而非 JDK（Java Development Kit）。JRE 仅包含运行字节码所需的 java 命令，但缺少 javac 编译器及注解处理器等开发必需组件。Gradle（尤其是 Spring Boot 插件 3.x）在构建阶段需调用 javac 进行源码编译、注解处理（如 @SpringBootApplication 元数据解析）及插件元数据加载——一旦 javac 不可用，整个构建流程将中断，导致依赖解析器甚至无法正确初始化，进而表现为“插件找不到”这一误导性报错。
✅ 验证与修复步骤：
-
检查当前 JAVA_HOME：
echo $JAVA_HOME ls -la $JAVA_HOME/bin/javac # 应返回有效路径；若提示 "No such file or directory"，则确认是 JRE
-
定位正确的 JDK 安装路径（macOS 示例）：
/usr/libexec/java_home -V # 列出所有已安装 JDK # 输出示例： # 17.0.8 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 17" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
-
更新环境变量（推荐写入
~/.zshrc或~/.bash_profile）：export JAVA_HOME=$(/usr/libexec/java_home -v 17) export PATH=$JAVA_HOME/bin:$PATH source ~/.zshrc # 重载配置
-
验证修复效果：
java -version # 应显示 JDK 版本（含 vendor 信息，如 "Temurin" 或 "Amazon Corretto"） javac -version # 必须可执行且版本匹配（如 17.0.8）
-
清理并重试构建：
cd /path/to/demo ./gradlew --stop # 停止旧守护进程 ./gradlew clean # 清理缓存 ./gradlew bootRun # 重新构建并启动
? 额外建议：
- 在 Eclipse 中，进入 Preferences → Java → Installed JREs，确保已添加并选中对应 JDK（而非 JRE）；
- 若使用 Spring Tools 4（STS），建议通过 File → Import → Existing Gradle Project 导入项目，避免手动创建 Java Project，以自动识别 Gradle 配置和依赖；
- Spring Boot 3.x 要求 JDK 17+，请勿混用 JDK 8/11 等旧版本——即使
java -version显示 17，也需确认javac同源。
完成上述配置后，./gradlew bootRun 将成功下载依赖（包括 spring-boot-gradle-plugin 和 spring-web）、编译源码，并启动嵌入式 Tomcat，默认监听 http://localhost:8080。此时 Eclipse 中的红色波浪线也将消失，所有 Spring 类型均可正常解析。
