讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决Gradle同步失败的问题_下载依赖超时的网络代理配置

酷雪小哥_3982

酷雪小哥_3982

发布时间:2026-03-21 18:27:38

|

1150人浏览过

|

来源于php中文网

原创

Gradle同步失败“Connection timed out”是代理未生效所致,因IDE启动JVM与Gradle子进程需双层代理配置,且需配合镜像源、TLS版本及DNS等协同调试。

如何解决gradle同步失败的问题_下载依赖超时的网络代理配置

Gradle同步失败:Connection timed out 是代理没生效

不是 Gradle 本身有问题,而是它根本没走你配的代理——默认情况下,gradle.properties 里的代理配置只对 Gradle 自身的 HTTP 请求生效(比如下载插件),但不自动透传给构建过程中调用的 javac、jar 或第三方工具链。更常见的是,IDE(如 Android Studio)启动时用的是自己的 JVM 参数,压根没加载你的 gradle.properties。

  • 确认代理是否真被读取:在项目根目录下运行 ./gradlew --version,再加 -Djavax.net.debug=system 看实际连接地址(注意输出里有没有 CONNECT 日志)
  • gradle.properties 必须放在用户主目录(~/.gradle/gradle.properties)才全局生效;放项目里只影响该工程,且某些 IDE 启动方式会跳过它
  • 如果用公司内网代理,检查是否需额外配置 systemProp.https.nonProxyHosts,否则 localhost、127.0.0.1 可能被错误转发

Android Studio 中 Gradle 代理必须双层配置

IDE 启动 JVM 和 Gradle 子进程是两个独立环境,只配一个地方等于白配。尤其在 macOS 或 Windows 上通过桌面图标启动时,JVM 参数不会继承 shell 的环境变量。

  • 第一层:IDE 自身网络 → Settings > Appearance & Behavior > System Settings > HTTP Proxy,选 Manual proxy configuration,填 host/port,并勾选 Proxy authentication(如有)
  • 第二层:Gradle 构建过程 → 打开 ~/.gradle/gradle.properties,添加四行(缺一不可):
    systemProp.http.proxyHost=127.0.0.1<br>systemProp.http.proxyPort=7890<br>systemProp.https.proxyHost=127.0.0.1<br>systemProp.https.proxyPort=7890
  • 改完后必须重启 Android Studio,且要清空 .gradle/caches/ 下的模块元数据(否则旧失败记录可能缓存并跳过重试)

Could not resolve org.jetbrains.kotlin:kotlin-stdlib-jdk8 类错误本质是仓库地址不可达

这个报错不是 Kotlin 版本冲突,而是 Gradle 根本连不上 mavenCentral() 或 google()。国内直连大概率超时,但很多人只改代理,忘了换仓库镜像——镜像源响应更快、更稳定,且不依赖本地代理稳定性。

  • 在 settings.gradle(或 settings.gradle.kts)里,把默认 mavenCentral() 替成清华源:
    maven { url "https://maven.tuna.tsinghua.edu.cn/repository/maven-central/" }
  • Android 项目还需显式替换 google():
    maven { url "https://maven.aliyun.com/repository/google" }
  • 不要同时保留原始仓库和镜像源(除非加 content { includeGroup "androidx.*" } 做分组路由),否则 Gradle 会按顺序逐个尝试,第一个超时就卡住

代理配置后仍失败?检查 DNS 和 TLS 版本兼容性

有些代理工具(如 Clash、Surge)默认禁用 SNI 或强制降级 TLS,而 Gradle 7+ 默认要求 TLSv1.2+ 且校验 SNI,导致握手失败,错误表现为 Received fatal alert: protocol_version 或静默卡在 “Resolving dependencies…”。

  • 临时验证是否 DNS 问题:在终端执行 curl -v https://repo.maven.apache.org,看是否能解析并建立连接
  • 强制 Gradle 使用 TLSv1.2:在 gradle.properties 加一行 org.gradle.jvmargs=-Dhttps.protocols=TLSv1.2
  • 如果代理是 mitm 类型(如 Fiddler、Charles),需手动将代理证书导入 JVM truststore,否则 PKIX path building failed 错误无法绕过
代理这事,最麻烦的从来不是配哪几行,而是你永远不知道哪一层悄悄绕过了它——IDE 启动参数、Gradle 守护进程缓存、JVM 默认协议栈、甚至系统级 DNS 设置,都可能让那几行 systemProp 形同虚设。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

4460

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

389

2026.05.09

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

20

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

20

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

20

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

20

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn