Android Studio Gradle同步失败求助：换DNS仍无效（伊朗制裁网络受限）

架构老林

2026-7-1

Android Studio Gradle同步失败（伊朗网络制裁场景）

错误表现：同步时无法连接Google Maven仓库、Gradle分发服务器，出现网络超时或连接拒绝提示

解决方案：

替换仓库为国内镜像
修改项目根目录的settings.gradle（或settings.gradle.kts），将官方仓库替换为可靠的国内镜像：

// Groovy DSL 示例
pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
    }
}

若使用Kotlin DSL，将语法调整为对应Kotlin格式即可。

手动下载Gradle包
1. 查看gradle/wrapper/gradle-wrapper.properties中的distributionUrl，确认所需Gradle版本
2. 从国内镜像站下载对应版本的zip包
3. 将zip包放到本地Gradle缓存目录（默认路径：~/.gradle/wrapper/dists/[版本号]/[随机目录]/）
4. 修改gradle-wrapper.properties中的distributionUrl为本地文件路径，示例：
```
distributionUrl=file:///Users/xxx/.gradle/wrapper/dists/gradle-7.5-bin.zip
```
配置可用代理
打开Android Studio设置：File > Settings > System Settings > HTTP Proxy，选择手动配置代理，填入可用的代理地址和端口，验证连接后应用设置。