Maven中央仓库依赖下载失败 代理连接超时致编译报错

1. 基础网络连通性校验 #

• 在运行Maven命令的 Windows Server 2019 机器上，打开CMD执行连通性测试命令：Test-NetConnection 10.218.129.49 -Port 443
• 如果TCP测试结果为失败，优先排查底层网络问题：
  • 确认配置指向的代理服务器10.218.129.49是否正常运行，443端口是否处于监听状态
  • 检查本机出站防火墙、内网安全组规则，是否拦截了本机到该IP端口的访问流量
• 临时将该代理配置到系统全局网络设置，测试走代理访问外部资源是否正常。如果系统层面走代理也超时，说明代理服务本身故障，无需调整Maven配置，直接联系代理运维恢复服务即可

2. 核对Maven代理配置准确性 #

• 定位当前Maven实际加载的配置文件：根据日志信息，本次运行的Maven根路径为F:\agentutility\apache-maven-3.6.3，全局配置默认路径为F:\agentutility\apache-maven-3.6.3\conf\settings.xml，注意排查用户目录下~/.m2/settings.xml是否存在覆盖全局配置的情况
• 检查配置文件中<proxies>节点的内容：
  • 核对代理host、port信息是否和实际可用的代理服务完全匹配，避免沿用已经下线、迁移过的旧代理地址
  • 检查代理协议类型匹配度：如果代理实际是HTTP类型运行在8080端口，错误配置为HTTPS类型443端口会直接触发连接超时
  • 核查代理认证配置：日志中显示当前代理配置的userName为null，如果目标代理服务需要身份校验，未填写正确的用户名密码会被服务端直接断开连接，最终表现为连接超时报错
  • 校验非代理白名单配置：如果内网本身可以直连公司私有Maven仓库，需要将私服地址加入<nonProxyHosts>列表，避免本来可以直连的资源还要绕无效的超时代理走

3. 临时兜底处理方案 #

• 暂时注释掉settings.xml中失效的代理节点，将Maven仓库地址替换为内网可直连的私有镜像地址，绕开公网代理的访问路径
• 针对拉取失败的依赖插件，可提前将对应版本的pom、jar文件手动放入本地仓库~/.m2/repository的对应路径，跳过远端拉取的流程

额外注意：如果当前Maven是在CI流水线Agent上运行，需要确认Agent服务的运行账号是否有访问代理服务器的权限，避免出现本地登录测试连通性正常，但服务运行账号被防火墙规则拦截的场景。

内容的提问来源于stack exchange，提问作者Satyam Pandey