自学内容网 自学内容网

Maven 在尝试连接到 Maven Central 仓库超时的解决方案和排查步骤

Maven 在尝试连接到 Maven Central 仓库时超时。以下是一些可能的解决方案和排查步骤:

1. 检查网络连接

确保你的网络连接正常,并且能够访问外网。

  • Ping 测试:

    ping repo.maven.apache.org
    
  • Telnet 测试:

    telnet repo.maven.apache.org 443
    

2. 配置代理

如果你在公司网络中使用代理服务器,需要配置 Maven 使用代理。

编辑 settings.xml

找到或创建 Maven 的 settings.xml 文件,通常位于 ~/.m2/settings.xml${MAVEN_HOME}/conf/settings.xml

添加代理配置:

<settings>
  <proxies>
    <proxy>
      <id>example-proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>proxypass</password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

3. 使用镜像仓库

有时直接连接到 Maven Central 可能会很慢或不稳定,可以配置国内的镜像仓库来加速依赖下载。

编辑 settings.xml

找到或创建 Maven 的 settings.xml 文件,通常位于 ~/.m2/settings.xml${MAVEN_HOME}/conf/settings.xml

添加镜像配置:

<settings>
  <mirrors>
    <mirror>
      <id>nexus-aliyun</id>
      <name>Nexus Aliyun Mirror</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
</settings>

4. 清除本地缓存

有时候本地缓存可能导致问题,可以尝试清除本地仓库中的缓存。

删除本地仓库

删除或重命名本地 Maven 仓库目录,通常位于 ~/.m2/repository

rm -rf ~/.m2/repository/com/baomidou/mybatis-plus-core

然后重新运行 Maven 构建命令。

5. 增加超时时间

增加 Maven 的连接和传输超时时间。

编辑 settings.xml

找到或创建 Maven 的 settings.xml 文件,通常位于 ~/.m2/settings.xml${MAVEN_HOME}/conf/settings.xml

添加超时配置:

<settings>
  <profiles>
    <profile>
      <id>custom-timeouts</id>
      <properties>
        <http.connection.timeout>60000</http.connection.timeout>
        <http.socket.timeout>120000</http.socket.timeout>
      </properties>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>custom-timeouts</activeProfile>
  </activeProfiles>
</settings>

6. 使用 -U 参数强制更新依赖

使用 -U 参数强制 Maven 更新所有快照和发布版本的依赖。

mvn clean install -U

7. 检查防火墙和安全组设置

确保防火墙或安全组没有阻止对 repo.maven.apache.org 的访问。

8. 使用 VPN 或其他网络

如果上述方法都不奏效,可以尝试使用 VPN 或切换到其他网络环境进行构建。

示例:配置 Maven 使用阿里云镜像

以下是配置 Maven 使用阿里云镜像的具体步骤:

  1. 编辑 settings.xml:
    打开或创建 ~/.m2/settings.xml 文件。

  2. 添加镜像配置:
    添加以下内容到 <settings> 标签内:

    <settings>
      <mirrors>
        <mirror>
          <id>nexus-aliyun</id>
          <name>Nexus Aliyun Mirror</name>
          <url>https://maven.aliyun.com/repository/public</url>
          <mirrorOf>central</mirrorOf>
        </mirror>
      </mirrors>
    </settings>
    
  3. 保存并关闭文件

  4. 重新运行 Maven 构建:

    mvn clean install
    

示例:配置 Maven 使用代理

以下是配置 Maven 使用代理的具体步骤:

  1. 编辑 settings.xml:
    打开或创建 ~/.m2/settings.xml 文件。

  2. 添加代理配置:
    添加以下内容到 <settings> 标签内:

    <settings>
      <proxies>
        <proxy>
          <id>example-proxy</id>
          <active>true</active>
          <protocol>http</protocol>
          <host>proxy.example.com</host>
          <port>8080</port>
          <username>proxyuser</username>
          <password>proxypass</password>
          <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
        </proxy>
      </proxies>
    </settings>
    
  3. 保存并关闭文件

  4. 重新运行 Maven 构建:

    mvn clean install
    

总结

通过以上步骤,你应该能够解决 Maven 下载依赖时遇到的连接超时问题。如果问题仍然存在,建议检查以下几点:

  • 网络连接: 确保网络稳定。
  • 代理设置: 如果使用代理,确保配置正确。
  • 镜像仓库: 使用国内镜像仓库加快下载速度。
  • 防火墙和安全组: 确保没有阻止对 Maven Central 的访问。

原文地址:https://blog.csdn.net/weixin_64401027/article/details/145135496

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!