Karate框架调用Feature文件时遭遇SocketTimeoutException问题求助

问题核心 #

拆分Feature文件调用时，/api/v1/applyOffer接口出现SocketTimeoutException，但将所有逻辑合并到单个Feature时可正常运行。根源在于Karate调用子Feature时会创建独立执行上下文，子Feature的HTTP请求可能占用连接池资源，导致主Feature后续请求无法获取可用连接，最终超时。

解决方案 #

方案1：在子Feature中强制关闭连接 #

修改EligibleOffer.feature，添加configure closeable = true确保请求完成后立即释放连接：

Scenario: Validate the user is able to get the eligible offers
* configure closeable = true
Given url baseUrl
And path '/api/v1/offers'
When method get
Then status 200

方案2：主Feature调用子Feature后重置HTTP客户端 #

在调用子Feature后，重置HTTP客户端，强制创建新的连接上下文：

And call read('classpath:features/EligibleOffer.feature')
* configure httpClient = null  // 重置客户端，避免连接占用
And path '/api/v1/applyOffer'
And method post
Then status 200

方案3：显式传递headers参数到子Feature #

避免依赖全局headers配置的上下文隔离问题，将headers作为参数传递给子Feature：

1. 修改EligibleOffer.feature接收headers参数：

Scenario: Validate the user is able to get the eligible offers
* configure headers = __arg.headers
Given url baseUrl
And path '/api/v1/offers'
When method get
Then status 200

2. 主Feature调用时传递headers：

And call read('classpath:features/EligibleOffer.feature') { headers: headers }
And path '/api/v1/applyOffer'
And method post
Then status 200

原理说明 #

Karate的call操作会为每个子Feature创建独立的执行上下文，子Feature中的HTTP请求默认会复用连接池中的连接。如果连接池配置的最大连接数不足，或者连接未及时释放，主Feature后续请求会因等待可用连接而超时。合并到同一Feature时，所有请求共享同一个客户端上下文，连接复用逻辑更高效，不会出现连接耗尽的情况。

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