构建Maven项目遇网络访问失败（连接超时），请求解决方法

• 检查基础网络连通性

  • 执行ping repo.maven.apache.org验证域名是否能正常解析并连通；再用telnet repo.maven.apache.org 443测试443端口是否可访问
  • 若连通失败，优先排查本地网络限制（如公司防火墙、校园网规则），也可手动修改hosts文件绑定报错中给出的仓库IP（例如146.75.112.215 repo.maven.apache.org）

• 配置Maven代理（适用于需要代理的网络环境）

  • 找到Maven配置文件settings.xml（路径通常为~/.m2/settings.xml或MAVEN_HOME/conf/settings.xml）
  • 在<proxies>节点中添加代理配置：

    <proxies>
      <proxy>
        <id>work-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>你的代理地址</host>
        <port>代理端口</port>
        <!-- 如需认证，补充以下内容 -->
        <username>代理账号</username>
        <password>代理密码</password>
        <nonProxyHosts>本地无需代理的域名，用|分隔</nonProxyHosts>
      </proxy>
    </proxies>
    

  • 保存配置后重新执行Maven命令

• 切换国内镜像仓库

  • 在settings.xml的<mirrors>节点中添加国内镜像替代中央仓库：

    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>central</mirrorOf>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    

• 清理本地缓存并重新构建

  • 删除~/.m2/repository下的缓存文件，再执行mvn clean install -U强制更新依赖

内容的提问来源于stack exchange，提问作者Yash Singh