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

Gradle 构建因 Maven 仓库连接超时失败的解决方案

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

jenkins 在 openshift 环境中执行 gradle 构建时，因无法访问 `repo.maven.apache.org` 导致依赖解析失败，根本原因是构建节点缺乏代理配置；本地成功而 ci 失败，典型体现为网络策略差异。

该错误本质是 Gradle 在无代理配置的受限网络环境中（如企业内网或 OpenShift Jenkins Agent）尝试直连公网 Maven 中央仓库，但因防火墙、NAT 或安全组策略导致 HTTPS 连接超时（Connect timed out），进而无法下载 spring-boot-gradle-plugin 和 dependency-management-plugin 等关键构建插件。

虽然 buildscript.repositories 中已声明 mavenCentral() 和 plugins.gradle.org，但这仅控制运行时依赖的仓库源，而 Gradle 自身在初始化阶段（如解析 classpath 插件）需通过 JVM 级网络层发起 HTTP(S) 请求——此时若未配置系统级代理，请求将直接失败。

✅ 正确解法：通过 gradle.properties 设置 JV

M 系统属性，显式声明 HTTPS 代理

在 Jenkins Pipeline 的工作目录（或 Gradle 用户主目录）下，确保存在 gradle.properties 文件，并添加以下代理配置（值需根据企业实际网络环境替换）：

# gradle.properties
systemProp.https.proxyHost=your-proxy.company.com
systemProp.https.proxyPort=8080
systemProp.http.nonProxyHosts="localhost|127.0.0.1|*.company.com|openshift.internal"
systemProp.https.proxyUser=your-username
systemProp.https.proxyPassword=your-password

⚠️ 注意事项：nonProxyHosts 使用 | 分隔，支持通配符 *，务必包含内部服务域名（如 OpenShift API 地址、私有 Nexus 仓库等），避免代理环路；若代理需认证，请同时设置 proxyUser 和 proxyPassword；敏感信息建议通过 Jenkins Credentials Binding 插件注入，而非硬编码；不推荐在 build.gradle 中用 System.setProperty() 动态设置——该方式在 Daemon 模式下可能不生效，且违反 Gradle 配置最佳实践；对于容器化 Jenkins Agent，可将 gradle.properties 作为 ConfigMap 挂载，或在 Pipeline 中通过 sh 命令动态生成。

? 补充建议（提升健壮性）：

在 buildscript { repositories { ... } } 中优先配置私有镜像仓库（如 Nexus/Artifactory），并启用 mavenCentral() 作为备用：

buildscript {
    repositories {
        maven { url "https://nexus.company.com/repository/maven-public/" }
        mavenCentral() // fallback
        maven { url "https://plugins.gradle.org/m2/" }
    }
    // ...
}

在 Jenkins Pipeline 脚本中验证代理是否生效：

sh 'curl -I https://repo.maven.apache.org/maven2/org/springframework/boot/spring-boot-gradle-plugin/2.7.7/spring-boot-gradle-plugin-2.7.7.pom --proxy http://your-proxy:8080'

总结：Gradle 构建超时问题多源于网络可达性缺失，而非配置语法错误。通过 gradle.properties 统一管理 JVM 网络代理，既符合 Gradle 官方推荐方式，又能确保 Daemon 复用、CI 环境一致性与安全性。

# word # apache # 编码 # 防火墙 # curl # proxy # jenkins # red # spring # maven # jvm # openshift # gradle # http # https # 而非 # 镜像 # 但这 # 又能 # 无法下载 # 可将 # 但因 # 内网 # 根本原因 # 复用

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

上一篇：B站官宣1月猛料！连续5天 5款国产单机大作首发预告

下一篇：VSCode集成终端使用技巧_VSCode终端运行多语言代码

相关栏目网站优化
网络推广
网络技术
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

上一篇：B站官宣1月猛料！连续5天 5款国产单机大作首发预告

下一篇：VSCode集成终端使用技巧_VSCode终端运行多语言代码