Gradle同步失败求助：导入Eclipse旧项目遇gradle-3.1.2-all.zip下载问题

云上老周

2026-5-26

解决Gradle Sync Failed: Cause: https://downloads.gradle.org/distributions/gradle-3.1.2-all.zip 的问题

我之前处理过不少旧项目的Gradle同步故障，针对你遇到的这个问题，给你几个实用的解决步骤，按顺序尝试应该能解决：

手动下载Gradle包并放入本地缓存
有时候官方下载链接因为网络原因无法访问，你可以直接找到gradle-3.1.2-all.zip的安装包下载到本地。然后找到IDE的Gradle缓存目录（通常在~/.gradle/wrapper/dists/gradle-3.1.2-all/下的随机命名文件夹里），把下载好的zip文件放进去，不要解压，之后重启IDE再同步项目。
修改Gradle配置文件换源
打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件，把distributionUrl的地址替换成国内镜像源，比如：
```
distributionUrl=http://mirrors.aliyun.com/gradle/distributions/gradle-3.1.2-all.zip
```
另外要注意，项目根目录的build.gradle里的Android Gradle插件版本要和Gradle 3.1.2兼容，推荐用com.android.tools.build:gradle:2.3.3，这个版本和Gradle 3.1.2是匹配的。
检查网络和代理设置
如果是在公司内网环境，可能代理拦截了下载请求。你可以打开IDE的设置（File -> Settings），找到Appearance & Behavior -> System Settings -> HTTP Proxy，确认代理配置是否正确，或者切换到个人热点等不受限制的网络再尝试同步。如果需要配置代理，也可以在项目的gradle.properties里添加以下内容：
```
systemProp.http.proxyHost=你的代理地址
systemProp.http.proxyPort=代理端口
systemProp.https.proxyHost=你的代理地址
systemProp.https.proxyPort=代理端口
```
清理IDE缓存重试
有时候缓存文件损坏也会导致同步失败，点击菜单栏的File -> Invalidate Caches...，选择Invalidate and Restart，等IDE重启后再重新同步项目。