Spring快速入门Demo构建失败：Gradle依赖解析及IDE导入问题求助

核心认知纠正 #

• demo.zip里没有Spring Framework库是正常现象：Gradle作为依赖管理工具，只会在构建时根据build.gradle的配置，从远程仓库自动下载所需依赖，不会把庞大的库文件提前打包到初始项目中。

构建失败的原因及对应解决 #

1. 网络连接问题（最常见） #

Gradle需要从Maven Central或Spring官方仓库下载spring-boot-gradle-plugin及其他依赖，若网络无法访问这些远程仓库，就会出现解析失败。

• 解决：
  • 检查网络连接，若需代理，在项目根目录创建gradle.properties文件，添加代理配置：

    systemProp.http.proxyHost=你的代理地址
    systemProp.http.proxyPort=代理端口
    systemProp.https.proxyHost=你的代理地址
    systemProp.https.proxyPort=代理端口
    

  • 或切换国内镜像仓库，修改项目根目录的settings.gradle：

    pluginManagement {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/public' }
            gradlePluginPortal()
        }
    }
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            maven { url 'https://maven.aliyun.com/repository/public' }
        }
    }
    

2. Gradle缓存损坏 #

本地Gradle缓存的依赖文件可能损坏，导致无法正常读取。

• 解决：删除macOS上的Gradle缓存目录，执行命令：

  rm -rf ~/.gradle/caches
  

  之后重新执行./gradlew bootRun，让Gradle重新下载所有依赖。

3. Eclipse项目导入方式错误 #

直接将文件夹移入工作区创建现有项目，Eclipse可能未启用Gradle插件识别项目结构，导致依赖无法同步。

• 解决：
  1. 删除当前Eclipse中的项目（保留本地文件）
  2. 打开Eclipse，选择File > Import > Gradle > Existing Gradle Project
  3. 选择解压后的demo文件夹，按向导完成导入，确保Gradle插件同步依赖

4. Gradle版本不兼容 #

Spring Boot 3.1.x要求Gradle版本至少为7.5，若项目内置的Gradle Wrapper版本过低，会无法支持对应插件。

• 解决：检查项目根目录gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为符合要求的版本，比如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
  

  重新执行./gradlew bootRun，Gradle会自动下载对应版本的Wrapper。

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