Gradle 构建中 Maven 仓库连接超时的解决方案_网络技术

Gradle 构建中 Maven 仓库连接超时的解决方案

发布时间 - 2026-01-26 00:00:00 点击率：次

本文详解 jenkins/openshift 环境下 gradle 构建因无法访问 maven 中央仓库（如 repo.maven.apache.org）导致 `connect timed out` 错误的根本原因与系统级代理配置方法，重点指导如何通过 `gradle.properties` 正确设置 https 代理以恢复依赖解析。

该错误并非

Gradle 或构建脚本本身的问题，而是运行环境（Jenkins Agent / Openshift Pod）缺乏对外网 Maven 仓库的网络访问能力——典型表现为 Connect to repo.maven.apache.org:443 [...] failed: connect timed out。本地构建成功而 CI 环境失败，恰恰印证了这是网络策略差异所致：企业内网通常强制走代理访问外网，而 Jenkins 节点或容器未配置相应代理参数，导致 Gradle 的 HTTP 客户端直连超时。

根本解决方式是为 Gradle 运行时显式声明系统级代理配置，推荐在项目级 gradle.properties 文件中设置（该文件会被 Gradle 自动加载，且可安全纳入版本控制，敏感值建议通过 CI 变量注入）：

# gradle.properties
systemProp.https.proxyHost=your-proxy.company.com
systemProp.https.proxyPort=8080
systemProp.http.proxyHost=your-proxy.company.com
systemProp.http.proxyPort=8080
systemProp.https.nonProxyHosts="localhost|127.0.0.1|*.company.com"
systemProp.http.nonProxyHosts="localhost|127.0.0.1|*.company.com"

⚠️ 注意事项：

proxyHost 和 proxyPort 必须替换为企业实际的代理地址与端口（常见为 http://proxy.corp:8080 或 https://proxy.corp:8443）；
若代理需认证，请额外添加：
```
systemProp.https.proxyUser=your-username
systemProp.https.proxyPassword=your-password
```
（注意：密码明文存在安全风险，生产环境应优先使用 Jenkins Credentials Binding 或环境变量动态注入）；
nonProxyHosts 使用 | 分隔，支持通配符 *，务必包含 localhost、127.0.0.1 及内网域名，避免代理环路；
不要删除 http.* 配置项——尽管 Maven 仓库使用 HTTPS，但 Gradle 内部部分逻辑仍会触发 HTTP 请求；
若 Jenkins Pipeline 中通过 sh 'gradle build' 执行，请确保 gradle.properties 位于工作目录或 $GRADLE_USER_HOME 下；也可在 Pipeline 中直接传参：
```
sh "gradle build -Dhttps.proxyHost=... -Dhttps.proxyPort=..."
```

此外，不建议在 build.gradle 中硬编码代理（如 System.setProperty()），因其仅影响 JVM 启动后阶段，无法覆盖 Gradle 初始化期间的仓库连接；也不推荐修改全局 $GRADLE_USER_HOME/gradle.properties，不利于多项目隔离。

总结：超时本质是网络可达性问题。通过标准化 gradle.properties 代理配置，既符合 Gradle 官方推荐实践，又能确保 Jenkins/Openshift 等受限环境稳定拉取依赖，是企业级 CI 流水线中可复用、可审计的基础设施方案。

# word # apache # 编码 # 端口 # ai # proxy # 环境变量 # jenkins # red # maven # jvm # openshift # gradle # http # https # 内网 # 这是 # 也不 # 运行环境 # 可在 # 可达 # 又能 # 多项 # 表现为 # 因其

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：1码等于多少米码与米的换算比例表【科普】

下一篇：如何用VSCode调试Laravel API返回JSON结构

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：1码等于多少米码与米的换算比例表【科普】

下一篇：如何用VSCode调试Laravel API返回JSON结构