本地构建代码遇Maven PKIX证书路径构建失败问题求助

先确认Maven使用的JDK路径 #

执行以下命令，查看Maven关联的Java环境：

mvn -version

重点看Java version和Java home，确保你之前导入证书的JDK和这个一致——很多人会安装多个JDK，容易导错位置。

重新检查证书导入步骤 #

1. 找到对应JDK的证书存储路径：
   • JDK8及以下：{JAVA_HOME}/jre/lib/security/cacerts
   • JDK11+：{JAVA_HOME}/lib/security/cacerts
2. 重新执行导入命令（替换路径为你的实际路径）：

   # Windows系统注意路径加引号
   keytool -import -alias maven-central -file D:/downloads/maven-central.crt -keystore "C:\Program Files\Java\jdk1.8.0_301\jre\lib\security\cacerts"
   # Linux/macOS
   keytool -import -alias maven-central -file ~/downloads/maven-central.crt -keystore /Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home/jre/lib/security/cacerts
   

   输入默认密码changeit，确认导入时输入y。
3. 验证证书是否导入成功：

   keytool -list -alias maven-central -keystore 上述cacerts路径
   

   如果能返回证书的详细信息，说明导入没问题。

排查Maven配置干扰 #

打开Maven的配置文件（全局的{MAVEN_HOME}/conf/settings.xml或用户目录下的~/.m2/settings.xml）：

• 检查是否配置了代理：如果有代理服务器，需要把代理的证书也导入到JDK的cacerts中，或者暂时注释代理配置测试。
• 检查仓库配置：确保central仓库的地址是https://repo.maven.apache.org/maven2，没有被改成HTTP或者其他镜像地址。
• 注释掉不必要的自定义仓库，避免冲突。

清理本地仓库缓存 #

删除本地仓库中对应构件的缓存目录，比如：

• Windows：C:\Users\{你的用户名}\.m2\repository\org\junit\junit-bom\5.6.2
• Linux/macOS：~/.m2/repository/org/junit/junit-bom/5.6.2
  删除后重新执行mvn clean install，让Maven重新下载构件。

临时测试方案（仅用于排查） #

如果以上步骤都没解决，可以用命令跳过证书验证，确认是否是证书问题：

mvn clean install -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true

如果这个命令能成功，说明还是证书导入的问题，回到前面的步骤仔细检查JDK路径和导入命令。

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