无法通过Android Studio或手动下载Gradle的问题求助

先排查拦截原因 #

• 测试域名连通性：
  打开终端/命令提示符，执行以下命令测试关键站点是否能正常访问：
  • 测试Gradle官方仓库：ping services.gradle.org
  • 测试GitHub存储节点：ping objects.githubusercontent.com
    也可以用telnet检查端口是否开放：telnet services.gradle.org 443，如果连接失败，说明端口被阻断。
• 检查系统防火墙：
  Windows用户打开「Windows Defender防火墙」，查看是否有拦截Android Studio或浏览器访问外部网络的规则；macOS用户进入「系统设置-网络-防火墙」，确认相关应用的网络权限。
• 检查浏览器与插件：
  关闭浏览器的广告拦截、隐私防护类插件，再尝试下载Gradle安装包；也可以换用其他浏览器测试，排除单一浏览器的拦截问题。

具体解决方法 #

1. 切换Gradle国内镜像源 #

修改项目配置文件，替换为国内镜像（如阿里云），避免访问被拦截的境外站点：

• 修改根目录settings.gradle：

pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    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' }
        google()
        mavenCentral()
    }
}

• 修改全局Gradle配置：
  找到Gradle全局配置文件（Windows：C:\Users\<你的用户名>\.gradle\gradle.properties；macOS/Linux：~/.gradle/gradle.properties），确保没有错误的代理配置：

# 清空无效代理（如果有）
systemProp.http.proxyHost=
systemProp.http.proxyPort=
systemProp.https.proxyHost=
systemProp.https.proxyPort=

2. 手动下载Gradle并配置离线模式 #

如果镜像源依然无法使用，手动下载后配置离线模式：

• 从国内镜像站下载对应版本的Gradle安装包（如gradle-7.5-all.zip）；
• 解压安装包到本地目录，比如C:\Gradle\gradle-7.5（Windows）或~/Gradle/gradle-7.5（macOS/Linux）；
• 打开Android Studio，进入「File > Settings > Build, Execution, Deployment > Gradle」；
• 选择「Use local gradle distribution」，指定解压后的Gradle目录；
• 勾选「Offline work」，点击「Apply」保存设置。

3. 调整防火墙与安全软件规则 #

• 系统防火墙：添加允许Android Studio、浏览器访问services.gradle.org和objects.githubusercontent.com的规则；
• 第三方安全软件：暂时关闭或添加上述站点到信任列表，测试是否能正常下载。

4. 检查Android Studio代理设置 #

进入「File > Settings > Appearance & Behavior > System Settings > HTTP Proxy」，选择「No proxy」（如果之前设置的代理已失效），或者配置可正常访问境外站点的代理，点击「Apply」后重启Android Studio。

内容的提问来源于stack exchange，提问作者Cliff Odebala Clarke