Java调用VPN环境下Dashboard接口出现PKIX路径构建失败错误

这个PKIX path building failed报错的核心原因是：你运行Java代码所用的JRE环境的默认信任证书库（cacerts）未将该Dashboard站点的SSL证书纳入信任列表，即使你本地浏览器能通过VPN访问站点，也不代表JRE会自动信任该证书。

方案一：将站点证书导入JRE信任库（推荐，生产环境可用） #

• 第一步：导出站点的SSL证书
  通过Chrome/Edge浏览器访问Dashboard地址，点击地址栏的锁形图标 → 选择「证书」 → 切换到「详细信息」标签页 → 点击「复制到文件」，选择Base64编码的X.509格式，导出保存为dashboard.cer文件。
• 第二步：导入证书到JRE的cacerts库
  找到你运行代码所用的JDK/JRE的路径，进入jre/lib/security目录，执行以下命令（注意替换实际路径和别名）：
  keytool -import -alias dashboard-cert -file 你导出的dashboard.cer路径 -keystore cacerts
  当提示输入密钥库密码时，cacerts的默认密码是changeit，输入后确认信任证书即可。如果执行命令时提示权限不足，Windows下用管理员身份运行命令行，Mac/Linux下命令前加sudo即可。
• 第三步：重启运行代码的进程，重新测试接口调用即可。

方案二：代码临时跳过SSL校验（仅用于本地调试，禁止生产使用） #

如果只是本地临时调试，可以在代码初始化HttpsURLConnection前添加跳过SSL证书校验和主机名校验的逻辑，代码如下：

// 这段代码添加在打开URL连接之前
TrustManager[] trustAllCerts = new TrustManager[]{
    new X509TrustManager() {
        public java.security.cert.X509Certificate[] getAcceptedIssuers() {
            return null;
        }
        public void checkClientTrusted(java.security.cert.X509Certificate[] certs, String authType) {
        }
        public void checkServerTrusted(java.security.cert.X509Certificate[] certs, String authType) {
        }
    }
};

// 安装全信任的SSL上下文
try {
    SSLContext sc = SSLContext.getInstance("SSL");
    sc.init(null, trustAllCerts, new java.security.SecureRandom());
    HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
    // 跳过主机名校验
    HttpsURLConnection.setDefaultHostnameVerifier((hostname, session) -> true);
} catch (Exception e) {
    e.printStackTrace();
}

• 如果你本地安装了多个JDK/JRE版本，一定要确认你运行代码用的是哪个版本的JRE，导入证书的时候要导入到对应版本的cacerts里，否则不生效。
• 你配置的Authenticator身份认证逻辑是正确的，证书问题解决后身份认证逻辑可以正常生效。

内容的提问来源于stack exchange，提问作者Rakshan Premsagar Kapikad