Android Studio出现Unknown host 'repo.maven.apache.org'报错如何解决？

完整报错信息：Unknown host 'repo.maven.apache.org'. You may need to adjust the proxy settings in Gradle.

该报错为Gradle构建时无法正常连接Maven中央仓库导致，可按以下步骤排查解决：

1. 验证基础网络连通性 #

• 直接在本机浏览器访问https://repo.maven.apache.org，确认是否可以正常打开页面
• 若无法打开，先切换其他可用网络（如手机热点）后重试项目同步

2. 修正Gradle代理配置 #

如果当前网络需要走代理才能访问公网，检查代理配置是否正确：

• 打开项目根目录下的gradle.properties文件，核对代理相关配置，示例配置参考：

# HTTP代理配置
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
# HTTPS代理配置
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890
# 代理需要账号密码时添加以下配置
systemProp.http.proxyUser=你的代理账号
systemProp.http.proxyPassword=你的代理密码

• 若当前网络不需要代理，直接删除gradle.properties中所有以systemProp.http、systemProp.https开头的配置行，避免错误代理配置影响网络请求

3. 替换为国内Maven镜像源 #

如果访问海外仓库网络不稳定，直接替换为国内镜像源提升连通率：

• Android Studio Arctic Fox及以上版本打开项目根目录的settings.gradle文件，低版本打开根目录的build.gradle文件，修改repositories块配置：

repositories {
    // 新增阿里云镜像
    maven { url 'https://maven.aliyun.com/repository/public' }
    maven { url 'https://maven.aliyun.com/repository/google' }
    // 原有官方仓库保留即可
    google()
    mavenCentral()
}

• 配置完成后点击Android Studio右上角的Sync Project with Gradle Files按钮重新同步项目

4. 其他排查项 #

• 检查本机hosts文件是否存在repo.maven.apache.org的错误映射，如有则删除对应条目后重试
• 临时关闭本机防火墙、安全防护软件后重试同步

内容的提问来源于stack exchange，提问作者kamal douma