Eclipse导入GitHub的Gradle+Spring Boot项目构建失败如何解决？

排查解决步骤 #

• 第一步：清理所有自动生成的IDE和构建配置
  关闭当前IDE，进入项目根目录，手动删除以下自动生成的文件/文件夹，不要删除你自己写的业务代码、build.gradle、settings.gradle、gradle文件夹、gradlew/gradlew.bat这些项目原生配置：

  • .gradle
  • build
  • .idea（IDEA用户）
  • .project
  • .classpath
  • .settings文件夹（Eclipse用户）

• 第二步：核对Gradle与JDK版本匹配关系
  打开项目内gradle/wrapper/gradle-wrapper.properties文件，查看distributionUrl对应的Gradle版本，确认你本地安装的JDK版本和该Gradle版本兼容：

  Gradle 6.x 支持JDK 8-15
  Gradle 7.x 支持JDK 8-16
  Gradle 8.x 支持JDK 8-19
  优先使用和你项目协作者一致的JDK版本，不要随意升/降大版本。

• 第三步：命令行优先验证构建能力，排除IDE配置问题
  打开终端进入项目根目录，执行对应系统的构建命令：

  • macOS/Linux：./gradlew clean build -x test
  • Windows：gradlew.bat clean build -x test
  • 若命令行构建成功：说明是IDE配置错误，重新打开IDE选择「从现有Gradle项目导入」，让IDE自动生成配置即可，不要手动修改.project这类自动生成的配置文件。
  • 若命令行构建失败：优先排查依赖拉取问题，可在build.gradle的repositories块最顶部加入阿里云镜像源加速依赖拉取：

    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        // 保留原本的其他仓库配置
    }
    

• 第四步：校验启动类配置
  确认Application.java放在项目最外层的根包下，比如你所有业务代码都在com.example.demo包下，启动类就要放在com.example.demo路径下，不要放到子包里，避免注解扫描失败。

参考截图

• Application.java文件截图：
• 报错信息截图：
• 项目目录结构截图：

内容的提问来源于stack exchange，提问作者john