解决 IntelliJ IDEA 中的 PKIX 路径构建失败问题

在使用 IntelliJ idea 运行 Java 程序时，如果遇到 PKIX path building failed 错误，通常是由于 jvm 无法验证 ssl 证书链导致的。本文将指导你如何通过导入缺失的证书到 JDK 和 intellij idea 的信任库中，解决此问题，确保程序能够安全地连接到 https 服务。

问题分析

PKIX path building failed 错误表明 Java 运行时环境 (JRE) 无法找到信任链来验证服务器提供的 SSL 证书。这通常发生在以下几种情况：

• 服务器使用了自签名证书或私有 CA 签发的证书，而你的 JRE 信任库中没有相应的根证书或中间证书。
• 证书链不完整，服务器没有发送所有必要的中间证书。
• 证书已过期或被吊销。

解决方案

解决此问题的关键是将缺少的证书导入到 JDK 和 IntelliJ IDEA 的信任库中。以下步骤详细说明了如何操作：

1. 获取缺失的证书

首先，你需要获取导致问题的服务器证书。可以通过浏览器访问该服务器的 HTTPS 地址，并导出其证书。

• 在浏览器中访问出现问题的 HTTPS 链接（例如：https://repo.maven.apache.org/maven2/org/slf4j/slf4j-simple/2.0.7/slf4j-simple-2.0.7.pom）。
• 找到浏览器地址栏中的锁形图标，点击查看连接信息。
• 选择“证书信息”或类似选项，进入证书详情页面。
• 在“详细信息”或“证书路径”选项卡中，选择证书链中的顶级证书（根证书），然后导出为 .cer 格式的文件。 将其保存到容易找到的位置，例如桌面。

2. 导入证书到 JDK 信任库

JDK 的信任库位于 $JAVA_HOME/lib/security/cacerts。你需要使用 keytool 命令将证书导入到该信任库中。

• 找到你的 JDK 安装目录，并进入 lib/security 目录。 确保 $JAVA_HOME 环境变量已正确设置。

• 打开终端或命令提示符，使用以下命令导入证书：

  sudo keytool -importcert -alias <证书别名> -file <证书文件路径>.cer -keystore cacerts
  • <证书别名>： 为证书指定一个唯一的别名，例如 maven_repo。
  • <证书文件路径>.cer： 替换为你导出的证书文件的完整路径。

  注意: 默认的 keystore 密码是 changeit。 输入密码时，控制台可能不会显示任何字符。

  示例:

  

  DeepSeek

  幻方量化公司旗下的开源大模型平台

  7087

  查看详情

  sudo keytool -importcert -alias maven_repo -file ~/Desktop/repo.maven.apache.org.cer -keystore cacerts

3. 导入证书到 IntelliJ IDEA 的 JRE 信任库

IntelliJ IDEA 使用自己的 JRE 运行。你需要将证书导入到 IntelliJ IDEA 使用的 JRE 的信任库中。

• 找到 IntelliJ IDEA 的安装目录，并进入 jbr/lib/security 目录。 实际路径可能因 IntelliJ IDEA 版本而异，通常类似于 /applications/IntelliJ IDEA.app/Contents/jbr/Contents/Home/lib/security。

• 使用与步骤 2 相同的 keytool 命令导入证书：

  sudo keytool -importcert -alias <证书别名> -file <证书文件路径>.cer -keystore cacerts

  示例:

  

  DeepSeek

  幻方量化公司旗下的开源大模型平台

  7087

  查看详情

  sudo keytool -importcert -alias maven_repo -file ~/Desktop/repo.maven.apache.org.cer -keystore cacerts

4. 重启 IntelliJ IDEA

完成证书导入后，重启 IntelliJ IDEA 以使更改生效。

注意事项

• 权限问题: 导入证书需要管理员权限，因此需要使用 sudo 命令。
• 密码: cacerts 文件的默认密码是 changeit。 如果你更改了密码，请使用正确的密码。
• 多个证书: 如果证书链中有多个缺失的证书，需要逐个导入。
• 版本差异: IntelliJ IDEA 和 JDK 的安装路径可能因版本和操作系统而异，请根据实际情况进行调整。
• 证书别名: 为每个证书选择一个唯一的别名，避免冲突。
• 安全风险: 导入不受信任的证书存在安全风险。 仅导入来自可信来源的证书。

总结

PKIX path building failed 错误通常可以通过将缺失的证书导入到 JDK 和 IntelliJ IDEA 的信任库中来解决。按照以上步骤操作，可以确保你的 Java 程序能够安全地连接到 HTTPS 服务。 请务必注意安全风险，并仅导入来自可信来源的证书。