SSL/TLS握手失败主因是环境、配置或网络问题，非代码错误；需依次排查时间同步、证书链完整性、JDK协议支持（如TLSv1.2/1.3）、信任库配置及代理干扰。
SSL/TLS 握手失败通常不是代码写错了，而是环境、配置或网络层面的问题。排查时别一上来就翻源码，先确认基础链路是否通畅、证书是否可信、协议版本是否兼容。
检查 JDK 版本和默认 TLS 协议支持
老版本 JDK（如 1.7 或早期 1.8）默认只支持 TLSv1.0 或 TLSv1.1，而很多服务端已禁用这些旧协议。JDK 8u251+ 默认启用 TLSv1.2，JDK 11+ 默认支持 TLSv1.3。
- 运行
java -version确认 JDK 版本 - 在代码中显式指定协议（临时验证）：
SSLContext context = SSLContext.getInstance("TLSv1.2"); - 启动参数加
-Dhttps.protocols=TLSv1.2,TLSv1.3强制启用新协议
验证目标服务端的证书链是否完整可信
常见原因是客户端信任库（cacerts）里没有服务端证书的根 CA 或中间 CA。浏览器能访问不代表 Java 能通——Java 不复用系统或浏览器证书库。
- 用
openssl s_client -connect host:port -showcerts抓取服务端返回的完整证书链 - 把根证书和中间证书导出为 PEM，用
keytool -importcert导入到 JDK 的$JAVA_HOME/jre/lib/security/cacerts（或自定义 truststore） - 启动时指定信任库：
-Djavax.net.ssl.trustStore=/path/to/truststore.jks -Djavax.net.ssl.trustStorePassword=changeit
抓包确认握手过程卡在哪一步
启用 JVM SSL 调试日志，比猜更直接：
立即学习“Java免费学习笔记（深入）”；
- 加 JVM 参数：
-Djavax.net.debug=ssl:handshake（精简输出）或-Djavax.net.debug=ssl:all（全量） - 日志中重点关注：
“No appropriate protocol” → 协议不匹配
“unable to find valid certification path” → 证书不可信
“Received fatal alert: handshake_failure” → 双方协商失败（可能是密钥交换算法不兼容，如服务端只支持 ECDHE-ECDSA，而客户端没启用对应 provider）
确认客户端是否被代理或中间设备干扰
企业内网常见 HTTPS 透明代理、防火墙 SSL 检查、负载均衡器终止 TLS 后重签证书等情况。
- 尝试绕过代理直连（改 hosts、换网络），看异常是否消失
- 对比 curl 和 Java 请求行为：
curl -v https://host是否同样失败？若 curl 成功但 Java 失败，大概率是 Java 信任库或协议问题 - 检查是否有自定义 SSLSocketFactory 或 TrustManager 逻辑，是否错误跳过了证书校验（开发测试常用但上线必须移除）
不复杂但容易忽略：多数握手失败背后是 TLS 版本、证书信任、网络中间件三者之一出了偏差，逐项排除比反复改代码更高效。
