Java中使用CXF生成存根调试SOAP接口调用时部分人出现SSL异常

问题根因 #

• 该报错的核心是SSL握手超时被服务端主动断开连接：外部SOAP服务的网关/服务器会对SSL握手过程设置超时阈值（通常为10-30秒），如果握手过程中客户端长时间没有返回响应，服务端就会主动重置连接，抛出Connection reset by peer、readHandshakeRecord相关异常。
• 逐行调试时线程会被挂起，如果断点刚好停在SSL握手的关键步骤（比如证书签名、校验、报文发送阶段），停留时间超过服务端的超时阈值，就会触发报错。断点间全速跳转运行时，整个握手过程几毫秒就能完成，自然不会触发超时。
• 团队内部分人员能复现、部分不能复现的差异通常来自两点：一是不同人的调试操作速度不同，手速快、断点停留时间短的人员不会触发阈值，停留时间长的会触发；二是部分人员的IntelliJ开启了调试自动求值特性，会额外挂起线程数秒，刚好超过超时阈值。
• 线程挂起导致服务端重置连接的说法是完全正确的，逐行调试本质就是通过断点主动挂起线程，刚好触发了服务端的超时断连策略。

可行的解决方案 #

• 优先方案：调试涉及SOAP调用的逻辑时，不要在发起SOAP调用的代码行、以及CXF内部调用相关的代码上逐行步进，仅在SOAP调用的前一行和后一行加断点，全速跳过调用过程即可。
• 如果必须调试SOAP调用的内部逻辑，可以临时修改CXF的客户端超时配置，拉长超时阈值：

import org.apache.cxf.endpoint.Client;
import org.apache.cxf.frontend.ClientProxy;
import org.apache.cxf.transport.http.HTTPConduit;
import org.apache.cxf.transports.http.configuration.HTTPClientPolicy;

// 在调用SOAP接口前执行以下代码
Client client = ClientProxy.getClient(你的SOAP存根实例);
HTTPConduit conduit = (HTTPConduit) client.getConduit();
HTTPClientPolicy policy = new HTTPClientPolicy();
// 把连接超时和读取超时都设置为5分钟，可根据调试需要调整
policy.setConnectionTimeout(300000);
policy.setReceiveTimeout(300000);
conduit.setClient(policy);

• 也可以关闭IntelliJ调试的自动求值特性，减少额外的线程挂起时间：打开File → Settings → Build, Execution, Deployment → Debugger → Data Views → Java，取消勾选自动计算字段值、自动调用toString()相关选项即可。

内容的提问来源于stack exchange，提问作者B.T.