Karate v0.9.6以上版本多线程并行测试HTTP调用报错问题咨询

1. 同类问题反馈情况 #

Karate 0.9.6版本后重构了底层HTTP客户端的连接池、线程调度逻辑，确实有大量用户反馈过类似并行执行异常问题：多线程运行一段时间后批量出现无额外日志的HTTP调用失败，单线程、串行执行完全正常。这类问题绝大多数都和新版本默认的连接池配置不匹配高并发场景、或者跨线程变量隔离逻辑变更有关，和你描述的故障特征完全吻合。

2. 详细日志获取方式 #

除了logback的DEBUG级别配置，还可以通过以下方式拿到全链路故障日志：

• 在karate-config.js中开启HTTP verbose日志：

  karate.configure('http', { 
    log: 'verbose',
    connectTimeout: 30000, 
    readTimeout: 60000
  })
  

  开启后会输出完整的HTTP请求、响应、连接分配回收的全流程信息。
• 增加JVM启动参数启用底层客户端日志：-Dkarate.http.client.debug=true，可以输出Apache HTTP客户端的连接池状态、连接申请失败的具体原因，确认是连接耗尽还是请求发送异常。
• 在并行执行的feature文件Background块增加线程标识日志：

  * karate.log('threadId:', java.lang.Thread.currentThread().getId(), 'running feature:', karate.feature.fileName)
  

  可以确认故障触发的时序，排除特定用例触发的问题。

3. 并行执行故障解决方案 #

按照优先级尝试以下配置调整：

• 首先调整HTTP连接池参数，0.9.6之后默认单域名最大连接数仅为20，总连接数200，高并发下很容易出现连接耗尽超时，可以在karate-config.js中修改配置适配你的并发规模：

  karate.configure('http', {
    maxConnectionsPerRoute: 100, // 单域名最大连接数，建议设为threadCount的2倍以上
    maxConnectionsTotal: 600, // 总连接数，大于你的测试用例并发峰值即可
    connectionPoolTTL: 30000 // 连接过期时间，避免后端主动断开的无效连接被复用
  })
  

• 排查全局变量线程安全问题：0.9.6之后并行用例的变量隔离逻辑收紧，如果你在karate-config.js中定义了可修改的共享对象、或者通过karate.set()操作跨用例共享变量，多线程下会出现变量污染，导致HTTP请求参数被篡改。所有需要修改的变量请放在feature文件的Background块中初始化，保证每个用例线程有独立的变量副本。
• 排查自定义扩展的线程安全问题：如果你用到了自定义Java工具类、第三方依赖，检查是否存在共用非线程安全实例、未同步的静态变量修改操作，这类问题也会导致多线程下批量调用失败。
• 建议直接升级到1.4.x及以上的最新正式版本，官方已经修复了0.9.6~1.2.0版本之间的多个HTTP连接池已知bug，稳定性远高于过渡版本。

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