Spring Boot服务调用外部服务偶发SSLProtocolException问题排查

先梳理下你的场景：你的Spring Boot服务使用Apache HttpClient 4.5.6调用不受管控的外部服务时，偶发出现这个超时异常，而且每次都是发送请求后等待近15分钟才抛出错误，这个时间点是关键线索。

异常产生的直接原因 #

从堆栈信息的根因java.net.SocketException: Connection timed out (Read failed)可以看出：
这不是TCP连接建立阶段的超时（如果是连接超时，异常会更早抛出），而是TCP连接已经成功建立，你的客户端发送请求后，一直无法从Socket输入流中读取到响应数据，直到操作系统层面的TCP超时机制触发，才抛出这个异常。

通常操作系统的TCP超时（比如Linux的tcp_retries2参数控制的重试周期）大概在15-30分钟左右，这正好匹配你遇到的15分钟等待时间——这说明你的Apache HttpClient没有配置应用层的Socket读取超时（socketTimeout），导致依赖了系统级的超时机制。

问题出在应用端还是外部服务端？ #

主要责任大概率在外部服务/网络链路： #

• 外部服务器可能在处理你的请求时发生了阻塞（比如线程死锁、资源耗尽、数据库查询超时），根本无法生成并返回响应；
• 网络中间设备（防火墙、负载均衡器）可能静默断开了这个长连接，但客户端没有感知到，还在持续等待响应；
• 外部服务器已经返回了响应，但响应数据包在网络传输过程中丢失，客户端一直收不到数据。

应用端存在的优化点： #

虽然异常的触发源于外部，但你的应用没有设置合理的超时时间，导致请求线程被长时间占用（15分钟），这会浪费线程资源，甚至可能引发线程池耗尽的问题，影响服务的整体可用性。

解决方案建议 #

1. 给Apache HttpClient配置合理的超时参数：
   一定要设置应用层的超时，避免依赖系统级的长超时。示例代码如下：

   // 构建请求配置，设置三种超时
   RequestConfig requestConfig = RequestConfig.custom()
       // 建立TCP连接的超时时间（比如5秒）
       .setConnectTimeout(5000)
       // 读取响应数据的超时时间（比如10秒）
       .setSocketTimeout(10000)
       // 从连接池获取连接的超时时间（比如3秒）
       .setConnectionRequestTimeout(3000)
       .build();
   
   // 初始化HttpClient时绑定默认配置
   CloseableHttpClient httpClient = HttpClientBuilder.create()
       .setDefaultRequestConfig(requestConfig)
       .build();
   

2. 增强日志监控：
   记录每次请求的URL、参数、发送时间、异常时间等细节，方便后续和外部服务方排查问题时提供依据。

3. 添加重试机制：
   对于偶发的超时问题，如果你的请求是幂等的（重复执行不会产生副作用），可以给HttpClient配置重试策略，比如使用HttpRequestRetryHandler。

4. 协同外部服务方排查：
   联系外部服务的维护团队，告知他们请求超时的时间点，让他们检查服务端的日志，看是否有对应的请求处理异常或超时记录。

内容的提问来源于stack exchange，提问作者Lebecca