Gradle下载超时问题处理办法

type

status

date

slug

summary

🔥 解决方案 1：手动下载 Gradle 并配置

💡 适用于：网络不稳定或访问 Gradle 官方站点缓慢的情况

步骤 1：手动下载 Gradle

访问 Gradle Release 站点或阿里云镜像：

Gradle 官方下载：https://services.gradle.org/distributions/

阿里云 Gradle 下载（国内推荐）：https://mirrors.cloud.tencent.com/gradle/

下载 gradle-8.11.1-bin.zip 并解压到本地目录，比如：

步骤 2：配置 Gradle

方式 1：全局环境

添加 GRADLE_HOME 变量

Windows：

右键 "此电脑" -> "属性" -> "高级系统设置" -> "环境变量"
在 "系统变量" 里新增 GRADLE_HOME，值设为 C:\gradle\gradle-8.11.1
找到 Path 变量，添加 C:\gradle\gradle-8.11.1\bin

macOS/Linux：

测试 Gradle 是否可用

✅ 成功后应该能看到 Gradle 版本信息

方式 2：项目级配置

如果不想改系统环境变量，也可以 在项目中配置 Gradle：

在 gradle/wrapper/gradle-wrapper.properties 里手动修改：

这样 Gradle 就不会从网上下载，而是直接用本地文件。

🚀 解决方案 2：更换 Gradle 镜像

💡 适用于：Gradle 官方源访问慢的问题

Gradle 下载默认是从 services.gradle.org 拉取，但国内访问可能会超时。可以 换成国内 Gradle 镜像 来加速。

方法 1：修改 `gradle-wrapper.properties`

打开 gradle/wrapper/gradle-wrapper.properties 文件，把 distributionUrl 改成 阿里云/腾讯云镜像：

或者：

方法 2：修改 `build.gradle` 代理

如果 你有代理服务器（VPN、代理工具等），也可以配置 Gradle 代理：在 gradle.properties 里添加：

💡 解决方案 3：增大 Gradle 超时时间

如果是 网络波动导致超时，你可以 提高 Gradle 连接超时时间 以防止中途断开：

修改 `gradle.properties`

在 gradle.properties 文件（通常在 ~/.gradle/gradle.properties）里加上：

⚡ 解决方案 4：强制使用 `offline` 离线模式

如果你的项目已经下载过 Gradle 依赖，可以用 离线模式，避免联网下载：

这样 Gradle 只会使用 本地缓存的依赖，不会尝试联网下载。

🎯 解决方案 5：检查防火墙 & VPN

💡 适用于：可能是网络限制的问题

有时候，Gradle 的下载可能被防火墙或 VPN 干扰：

检查防火墙是否拦截：

关闭 Windows 防火墙（或 macOS 防火墙）

允许 java.exe 和 gradle.exe 访问网络

尝试换网络：

用手机热点 连接试试看

使用 VPN 或代理（例如科学上网）

🛠️ 解决方案 6：更新 Gradle 版本

如果 Gradle 版本有 bug，试试用 最新版本 或 稳定版本：

然后在 gradle/wrapper/gradle-wrapper.properties 里手动改成 稳定版本：

🎯 终极方案：换个 Gradle 版本试试

如果 Gradle 8.11.1 下载有问题，试试 Gradle 8.5 或其他稳定版本：

然后重新构建：

✅ 总结

方案	适用场景	操作方式
手动下载 Gradle	无法访问 Gradle 服务器	手动下载 `.zip` 并配置路径
换国内 Gradle 镜像	访问 Gradle 官方站点慢	使用阿里云或腾讯云
增加超时时间	下载速度慢	修改 `gradle.properties`
离线模式	已下载依赖但 Gradle 无法联网	`gradle build --offline`
检查防火墙/VPN	网络限制	关闭防火墙/尝试换网络
更新 Gradle 版本	当前版本有 bug	`gradle wrapper --gradle-version 8.5`

🔧 推荐操作：

✅ 最简单的方法：先试试 国内 Gradle 镜像（方案 2），如果不行就 手动下载 Gradle（方案 1）。

🔥 如果你的 Gradle 版本有问题，直接换 8.5 版本试试！

😎 搞定后可以来给我报个喜！ 🎉