Karate连接复用异常：Azure SNAT耗尽引发ConnectTimeoutException

核心原因 #

Karate 默认的 HttpClient 配置可能未启用合适的连接池策略，导致每次请求新建TCP连接，最终触发Azure SNAT端口耗尽，抛出org.apache.http.conn.ConnectTimeoutException。即使响应头包含keep-alive，连接也可能因连接池配置不合理被过早回收。

解决方案 #

1. 自定义HttpClient连接池配置 #

通过自定义Apache HttpClient的连接池管理器，强制启用连接复用。可以在Karate的初始化脚本（如karate-config.js或Java钩子）中添加以下配置：

import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;

// 初始化连接池管理器
PoolingHttpClientConnectionManager connManager = new PoolingHttpClientConnectionManager();
// 设置全局最大连接数，根据并发需求调整
connManager.setMaxTotal(100);
// 设置单个目标主机的最大连接数
connManager.setDefaultMaxPerRoute(20);
// 设置空闲连接存活时间（毫秒），避免连接过早被回收
connManager.setValidateAfterInactivity(300000); // 5分钟

// 构建自定义HttpClient
HttpClientBuilder clientBuilder = HttpClientBuilder.create().setConnectionManager(connManager);
// 将自定义HttpClient配置到Karate
karate.configure("httpClient", clientBuilder.build());

2. 明确启用Keep-Alive #

在Feature文件的Background中显式开启Keep-Alive配置：

Background:
  * url "https://www.karatelabs.io/"
  * configure keepAlive = true

3. 检查并升级Karate版本 #

若使用0.9.x及更早版本的Karate，默认HttpClient可能采用单连接管理器（BasicHttpClientConnectionManager），无法实现连接复用。建议升级到1.x系列的最新稳定版，新版本默认使用连接池管理器，配合上述配置可大幅优化连接复用效果。

4. 调整超时配置 #

确保connectionTimeout和readTimeout设置合理，避免因超时导致连接被强制关闭：

* configure connectionTimeout = 30000 // 30秒
* configure readTimeout = 120000 // 120秒

验证方法 #

修改配置后重新运行测试场景，查看调试日志：

• 首次请求后，后续请求不应重复出现Connecting to socket和handshake日志（复用连接时不会触发新连接建立）
• http-outgoing-x: Shutdown connection日志会减少，仅在连接空闲超时或达到连接池上限时出现

内容的提问来源于stack exchange，提问作者Mohammed Amine Jallouli