Spring Web调用SpringBoot接口仅调用方报ConnectionPoolTimeoutException排查

首先明确：当前报错是调用侧Apache HttpClient连接池无法获取可用连接，请求尚未发送到新SpringBoot服务端，因此你之前调整的服务端Tomcat配置不会生效，优先排查调用侧逻辑：

1. 核对HttpClient单路由连接配额 #

• 确认代码中connectionMgrMaxPerRouteSecure参数的实际配置值，该参数为单个目标路由（域名+端口组合）的最大并发连接上限，和总连接数connectionMgrMaxTotalSecure为独立限制规则。其他正常调用的接口对应不同路由，配额充足不代表新SpringBoot服务对应的路由配额足够，这是单目标服务报连接池超时的最常见原因。
• 可通过JMX、埋点定期输出PoolingHttpClientConnectionManager运行指标：查看目标路由的已用连接数、等待队列长度，确认是否触及配置上限。

2. 排查连接泄漏/资源无效占用问题 #

• 确认HttpClient实例为全局单例复用：如果每次请求都新建HttpClient实例，每个实例会持有独立连接池，会快速耗尽系统连接资源。
• 虽然你使用了BasicResponseHandler会自动回收响应流，仍需检查所有异常分支（如请求超时、抛出非IOException异常）中是否主动调用HttpRequestBase#abort()释放资源，避免异常场景下连接泄漏。
• 核对调用侧空闲连接回收逻辑：HttpClient默认不会主动清理空闲连接，如果新SpringBoot服务端主动断开空闲连接的时间短于调用侧的空闲连接淘汰周期，连接池会积攒大量已失效的半开连接，请求获取到无效连接后要等待超时才会淘汰，间接导致连接池被占满。
• 可在调用侧服务器用ss -antp | grep <新SpringBoot服务端口>命令查看TCP连接数，对比connectionMgrMaxPerRouteSecure配置值，如果连接数长期卡在配置上限不再上涨，基本可确认是配额不足或连接泄漏。

3. 核对超时参数配置 #

• 确认secureRequestConfig中ConnectionRequestTimeout（从连接池获取连接的超时时间）配置是否过短：如果新接口响应耗时远高于其他正常接口，相同QPS下每个连接的占用时间更长，等待队列中的请求很容易触发该超时。
• 对比新接口和其他正常接口的平均响应时间、TP99响应时间，如果新接口响应明显更慢，需对应调高单路由连接配额。

4. 排除网络层问题 #

• 在调用侧服务器直接用curl/postman调用新SpringBoot接口，确认是否存在网络丢包、TCP握手慢、DNS解析延迟高的问题，这类问题会导致连接占用时间拉长，快速打满连接池配额。
• 确认调用侧到新SpringBoot服务的端口是否有安全组、防火墙拦截，避免部分连接被拦截后无响应，长期占用连接池资源。

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