Maven更新失败问题：代理设置与PKIX证书路径错误

一、PKIX证书路径构建失败问题 #

这个错误是JVM无法验证Maven中央仓库的SSL证书导致的，解决方法分两种：

1. 导入中央仓库证书到JVM信任库（推荐） #

• 打开浏览器访问https://repo.maven.apache.org/maven2，点击地址栏的锁形图标，导出网站证书（保存格式选DER或PEM）
• 打开终端，执行keytool命令导入证书（替换占位符为实际路径）：

  keytool -import -alias maven-central -keystore $JAVA_HOME/jre/lib/security/cacerts -file /path/to/your/certificate.cer
  

  • JDK 11及以上版本，信任库路径为$JAVA_HOME/lib/security/cacerts
  • 信任库默认密码是changeit，按提示输入即可完成导入

2. 临时跳过SSL验证（仅测试用，不推荐生产环境） #

执行Maven命令时添加参数：

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

二、parent.relativePath指向错误本地POM问题 #

• 打开项目根目录的pom.xml，找到<parent>标签下的<relativePath>配置：
  • 如果本地确实有该parent POM文件，修改路径为正确的本地路径（比如../spring-boot-starter-parent/pom.xml）
  • 如果本地没有该POM文件，直接删除<relativePath>标签，Maven会自动从配置的仓库中拉取对应的parent构件

三、代理配置检查 #

结合你的settings.xml代理设置，补充以下检查：

• 确认代理的<active>属性设为true，确保代理生效
• 检查代理的host、port、username、password（如果需要）配置是否正确
• 如果代理服务器使用自签名SSL证书，需要把代理的证书也导入到JVM信任库（步骤同一的证书导入）
• 可以用curl测试代理连通性：

  curl -x 代理地址:端口 https://repo.maven.apache.org/maven2
  

  能正常返回仓库目录说明代理配置没问题

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