Android Studio项目同步失败:无法从gradle插件仓库等源下载依赖
检查Gradle代理配置
公司网络下浏览器通常会自动使用系统代理,但Gradle默认不会继承该设置。打开项目根目录的gradle.properties文件,添加或修改代理配置(替换为你浏览器使用的代理信息):systemProp.http.proxyHost=你的代理IP或域名 systemProp.http.proxyPort=代理端口 systemProp.https.proxyHost=你的代理IP或域名 systemProp.https.proxyPort=代理端口 # 如果代理需要认证,添加以下两行 # systemProp.http.proxyUser=代理用户名 # systemProp.http.proxyPassword=代理密码 # systemProp.https.proxyUser=代理用户名 # systemProp.https.proxyPassword=代理密码若之前存在错误的代理配置,直接删除即可。注意Gradle不支持PAC自动代理,必须使用固定的代理地址。
验证Android Studio代理设置
打开Android Studio,进入File > Settings > Appearance & Behavior > System Settings > HTTP Proxy:- 选择
Manual proxy configuration,填入和浏览器一致的代理地址、端口,若有认证信息也一并填写。 - 点击
Check connection,输入https://repo.maven.apache.org/maven2测试连通性,确认能成功连接后再保存设置。
- 选择
确认Gradle仓库配置正确性
打开项目根目录的Project级build.gradle文件,确保仓库配置包含所需的官方地址,不要使用失效的仓库源:repositories { google() mavenCentral() maven { url "https://plugins.gradle.org/m2/" } }清除Gradle缓存
缓存损坏可能导致依赖下载失败,手动删除Gradle缓存目录:- Windows:
C:\Users\<你的用户名>\.gradle\caches - Mac/Linux:
~/.gradle/caches
删除后重启Android Studio,重新执行Sync Project with Gradle Files,让Gradle重新下载依赖。
- Windows:
排查公司防火墙/安全软件限制
部分公司防火墙会拦截IDE的网络请求,但允许浏览器访问。联系IT部门确认是否需要将plugins.gradle.com、repo.maven.apache.org、dl.google.com这些域名加入白名单;同时检查本地杀毒软件、防火墙是否拦截了Android Studio的网络请求,可暂时关闭测试,确认后添加信任规则。调整Gradle版本或关闭离线模式
特定版本的Gradle可能存在网络兼容问题,可尝试在Project级build.gradle中调整Gradle插件版本:dependencies { classpath "com.android.tools.build:gradle:7.4.2" // 替换为稳定版本 }同时确保
File > Settings > Build, Execution, Deployment > Build Tools > Gradle中的Offline work未被勾选,避免Gradle处于离线状态无法下载新依赖。
内容的提问来源于stack exchange,提问作者Yiftach Cohen

