Vert.x SSL服务端客户端健康检测测试报SSLHandshakeException如何解决

算力阿峰

2026-9-27

解决方案

错误原因

你给WebClient配置的PemKeyCertOptions是用于双向SSL认证时客户端提交自身身份证书的配置，并非指定客户端需要信任的服务端自签名证书，因此客户端依旧使用JVM默认信任库校验服务端的自签名证书，自然会触发PKIX路径校验失败的错误。

可选方案

方案1：测试环境直接跳过证书校验（最便捷，单元测试优先推荐）

单元测试场景不需要严格的证书校验，直接在WebClient配置中开启信任所有证书即可，无需修改任何JVM配置，所有拉取代码的开发者可以直接运行：

WebClientOptions options = new WebClientOptions()
        .setSsl(true)
        .setTrustAll(true); // 仅测试环境使用，生产环境禁止开启
WebClient client = WebClient.create(vertx, options);

方案2：显式配置客户端信任指定自签名证书（无需修改全局JVM配置）

如果需要保留证书校验逻辑，可以通过PemTrustOptions指定客户端信任你的自签名证书，不需要修改JVM全局信任库，只要将cert.pem放在项目中随代码提交，所有开发者拉取后即可直接运行：

WebClientOptions options = new WebClientOptions()
        .setSsl(true)
        .setPemTrustOptions(new PemTrustOptions()
                .addCertPath("cert.pem")); // 仅信任你指定的自签名证书
WebClient client = WebClient.create(vertx, options);