Android Studio 构建项目时 Gradle 下载失败的解决方案

一、问题原因分析

根据错误日志：

下载地址 https://services.gradle.org/distributions/gradle-8.1-bin.zip 连接超时（10秒）。

可能原因：

网络环境限制（如公司防火墙、地区网络屏蔽）。

代理配置未生效或配置错误。

Gradle 官方服务器临时不可用。

二、解决方案

方案1：配置国内镜像代理（推荐）

修改项目级 gradle-wrapper.properties
在项目目录中找到：
gradle/wrapper/gradle-wrapper.properties
替换下载地址为国内镜像（如腾讯云）：

distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.1-bin.zip 

全局代理设置
在 ~/.gradle/gradle.properties 中添加：

systemProp.https.proxyHost=mirrors.aliyun.com systemProp.https.proxyPort=80 

方案2：手动下载并安装 Gradle

下载 Gradle 分发包

从腾讯云镜像下载对应版本的 .zip 文件。

保存至本地目录（如 C:\gradle\gradle-8.1-bin.zip）。

配置本地路径
在 gradle-wrapper.properties 中修改为：

distributionUrl=file:///C:/gradle/gradle-8.1-bin.zip 

方案3：调整超时时间与清理缓存

增加超时时间
在 gradle.properties 中添加：

org.gradle.internal.http.socketTimeout=60000 org.gradle.internal.http.connectionTimeout=60000 

清理缓存
执行以下命令：

rm -rf ~/.gradle/wrapper/dists  # macOS/Linux del /s /q "%USERPROFILE%\.gradle\wrapper\dists"  # Windows 

三、验证步骤

重新同步项目（点击 Sync Project with Gradle Files）。

查看 Build 输出窗口，确认是否从镜像地址下载：

Downloading https://mirrors.cloud.tencent.com/gradle/gradle-8.1-bin.zip 

若仍失败，检查网络代理或尝试关闭防火墙。