【Gradle】Could not install Gradle distribution from ‘https://services.gradle.org/distributions/gradle

问题描述

Android Studio 项目同步 Gradle 失败。

Gradle Sync Error

Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-8.9-bin.zip'.
Reason: java.net.SocketTimeoutException: Connect timed out

原因分析

Android Studio 在尝试从 https://services.gradle.org/distributions/gradle-8.9-bin.zip 下载 Gradle 分发包时,未能在规定时间内完成连接,因而抛出了 java.net.SocketTimeoutException: Connect timed out 异常。

这通常是由于网络环境不稳定或访问目标服务器的网络速度较慢所引起的。


解决方案

方法1

  1. 手动下载 Gradle distribution
    https://services.gradle.org/distributions/gradle-8.9-bin.zip

  2. 在 Android Studio 设置中,将 Gradle Distribution 从 Wrapper 改为 Local Installation
    Android Studio Settings

  3. 将 Gradle Distribution 路径设为手动下载的 Gradle 路径
    Set Gradle Path

方法2

修改 gradle/wrapper/gradle-wrapper.propertiesdistributionUrl

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

改为腾讯源:

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.9-bin.zip
### 解决 Gradle 安装失败的方法 当遇到无法从指定 URL `https://services.gradle.org/distributions/gradle-8.10.2-bin.zip` 安装 Gradle 的情况时,可以采取以下措施来解决问题。 #### 更改 Gradle 配置文件中的下载地址 为了提高下载速度并确保成功获取所需的 Gradle 版本,建议更改 `gradle/wrapper/gradle-wrapper.properties` 文件中的 `distributionUrl` 属性指向国内镜像站点。例如: ```properties distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-bin.zip ``` 这一步骤能够有效规避因国际网络连接不稳定而导致的下载中断问题[^2]。 #### 设置合理的超时时间和其他参数 除了更换镜像源之外,在同一配置文件内还可以设置更长的 `networkTimeout` 参数值以防止因为短暂的网络波动造成请求被取消;同时启用 `validateDistributionUrl` 来验证所使用的分发链接是否合法。完整的配置如下所示: ```properties distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-bin.zip networkTimeout=10000 validateDistributionUrl=true zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists ``` 通过上述调整,不仅提高了下载成功率,也增强了系统的健壮性和安全性[^4]。 #### 手动下载并放置 Gradle 压缩包 如果仍然面临困难,则可以选择手动方式处理——先访问选定的镜像站下载对应的 `.zip` 文件至本地计算机上,之后将其解压到合适的位置(比如用户的主目录下的隐藏文件夹`.gradle`),最后更新环境变量使得命令行工具可以直接调用新版本的 Gradle 可执行程序[^5]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值