在使用 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。 输入密码时，控制台可能不会显示任何字符。
示例:
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
示例:
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 服务。 请务必注意安全风险，并仅导入来自可信来源的证书。
