部署Spring Boot到Heroku报错：无法解析spring-boot-gradle-plugin:3.0.2

算力阿峰

2026-8-2

无法解析org.springframework.boot:spring-boot-gradle-plugin:3.0.2的原因及解决方法

出现这个错误通常是以下几种情况导致，对应的解决方式如下：

Gradle仓库配置缺失
Spring Boot插件需要从Spring专属仓库或Maven Central拉取。检查你的settings.gradle或build.gradle是否配置了正确的仓库：
在settings.gradle中确保包含Spring仓库：
```
pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
        maven { url 'https://repo.spring.io/release' }
    }
}
```
或者在build.gradle的插件仓库部分添加上述配置。
Gradle版本不兼容
Spring Boot 3.0.2要求使用Gradle 7.4及以上版本。检查项目根目录的gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl，确保版本符合要求：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
```
如果版本过低，更新后重新提交代码。
依赖缓存异常
本地或Heroku构建缓存可能存在损坏。可以先在本地执行./gradlew clean build --refresh-dependencies刷新依赖，然后重新推送代码到Heroku；也可以在推送时添加--no-cache参数强制Heroku重新拉取依赖：
```
git push heroku main --no-cache
```
网络访问限制
Heroku构建环境如果无法访问Maven Central或Spring仓库，会导致依赖拉取失败。这种情况可以尝试切换到国内镜像仓库（如果适用），或者检查Heroku的网络连接状态。