公司网络下Maven无法加载依赖，如何排查故障？

1. 核对Maven配置文件 #

• 检查全局/用户级settings.xml：分别查看{Maven安装目录}/conf/settings.xml和~/.m2/settings.xml，确认是否配置了中央仓库与公司仓库的节点，示例配置：

  <repositories>
    <repository>
      <id>central</id>
      <url>https://repo.maven.apache.org/maven2</url>
      <releases><enabled>true</enabled></releases>
    </repository>
    <repository>
      <id>company-repo</id>
      <url>https://your-company-git-repo/maven</url>
      <releases><enabled>true</enabled></releases>
    </repository>
  </repositories>
  

• 确认代理配置：公司VPN环境通常需要代理，检查<proxies>节点的地址、端口、认证信息是否与同事一致。
• 排查镜像覆盖：如果有<mirrors>节点，确认是否将中央仓库镜像到了公司内部仓库，避免直接请求外部仓库被拦截。

2. 验证证书有效性 #

• 手动测试SSL连通性：执行curl -v https://repo.maven.apache.org/maven2，若输出SSL certificate problem，说明证书信任存在问题。
• 检查JDK信任库：用keytool查看IntelliJ使用的JDK信任库（路径为{JDK目录}/jre/lib/security/cacerts）：

  keytool -list -keystore /path/to/jdk/jre/lib/security/cacerts -storepass changeit
  

  搜索是否存在公司或中央仓库的证书，缺失则重新导入：

  keytool -import -alias company-cert -file /path/to/company-cert.crt -keystore /path/to/jdk/jre/lib/security/cacerts -storepass changeit
  

• 禁用不安全配置：若settings.xml中存在maven.wagon.http.ssl.insecure或maven.wagon.http.ssl.allowall，暂时注释掉，确保依赖证书验证逻辑。

3. 核对IntelliJ的Maven配置 #

• 打开File > Settings > Build, Execution, Deployment > Build Tools > Maven：
  • 确认Maven home directory、User settings file与同事完全一致，勾选Override确保配置生效。
• 刷新仓库列表：切换到Repositories标签页，点击Refresh，若仍无目标仓库，手动添加地址测试连通性。
• 强制刷新依赖：在右侧Maven面板点击Reload All Maven Projects，查看Run面板日志，定位具体错误（如连接超时、证书错误）。

4. 命令行测试Maven功能 #

• 脱离IntelliJ，在项目根目录执行mvn clean install -U，通过控制台日志定位问题：
  • 出现SSLHandshakeException：重新检查证书导入流程；
  • 出现Connection refused/Timeout：确认代理配置或联系IT排查VPN端口权限；
  • 出现Repository not found：检查仓库URL是否正确，或补充<servers>节点的认证信息。

5. 检查本地仓库状态 #

• 删除~/.m2/repository下Spring相关的缓存文件夹，重新执行mvn clean install -U。
• 确认~/.m2/settings.xml无权限问题（如只读），确保Maven可读取配置。

6. 对比同事配置细节 #

• 直接导出同事的settings.xml与本地文件对比，排查拼写错误、节点遗漏等细微差异。
• 核对IntelliJ的JDK版本、Maven版本、信任库路径，确保完全一致。

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