一、Gradle本体安装加速（解决distributionUrl下载失败）

问题现象：
执行gradlew时卡在Downloading https://services.gradle.org/distributions/gradle-x.x-bin.zip，因网络无法下载。

解决方案：

1，手动下载镜像包

从国内镜像站下载对应版本的Gradle发行包（示例为8.6）：

# 阿里云镜像
https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.6-bin.zip

# 腾讯云镜像
https://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip

2，修改Wrapper配置(推荐)

在项目根目录的gradle/wrapper/gradle-wrapper.properties中，替换distributionUrl为国内镜像地址：

distributionUrl=https\://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.6-bin.zip

3，手动放置文件（可选）

若自动校验失败，将下载的ZIP文件放入本地缓存目录：

# 路径示例（随机字符目录需自动生成）
~/.gradle/wrapper/dists/gradle-8.6-bin/<随机目录>/gradle-8.6-bin.zip

二、Gradle依赖加速（配置build.gradle镜像源）

问题现象：
项目构建时卡在Download https://repo.maven.apache.org/...，依赖下载极慢或失败。

解决方案：
在项目的build.gradle文件中添加国内镜像仓库：

1，Groovy DSL 配置

repositories {
    // 阿里云镜像（覆盖所有仓库）
    maven { url 'https://maven.aliyun.com/repository/public' }
    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
    
    // 中央仓库（备用）
    mavenCentral()
}

2，Kotlin DSL 配置（build.gradle.kts）

repositories {
    maven {
        url = uri("https://maven.aliyun.com/repository/public")
    }
    maven {
        url = uri("https://maven.aliyun.com/repository/google")
    }
    maven {
        url = uri("https://maven.aliyun.com/repository/gradle-plugin")
    }
    mavenCentral()
}

注意：当使用镜像插件下载失败的时候记得把官方仓库给优先放上去，可能是因为镜像里没有当前插件版本（经验之谈）

3，注意事项

1，验证Gradle本体安装

执行命令检查版本是否匹配：

./gradlew --version

2，常见问题

• 镜像不生效：确保repositories配置在buildscript和allprojects块中。
• 缓存干扰：清理旧缓存：rm -rf ~/.gradle/caches/modules-2/
• HTTPS证书问题：镜像地址使用http（非推荐）或更新系统证书库。

三、总结流程图

Gradle安装问题：

• 本体下载失败--》修改gradle-wrapper.properties--》distributionUrl替换为国内镜像
• 依赖下载失败--》修改build.gradle--》添加阿里云镜像仓库

通过**修改distributionUrl + 配置build.gradle镜像**，可彻底解决Gradle在国内环境下的安装与依赖问题。

原文链接：https://blog.csdn.net/x0_5904/article/details/147027295