You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio项目同步失败:无法从gradle插件仓库等源下载依赖

Android Studio依赖下载失败(浏览器可正常访问)的解决办法
  • 检查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重新下载依赖。
  • 排查公司防火墙/安全软件限制
    部分公司防火墙会拦截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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.27 10:02:54