Karate 1.3.1多线程访问异常问题咨询及原因排查

问题背景 #

为优化测试场景执行效率切换到多线程模式后，触发了GraalJS的线程访问限制异常：

java.lang.IllegalStateException: Multi-threaded access requested by thread Thread[http-nio-8778-exec-1,5,main] but is not allowed for language(s) js.

该异常仅出现在通过Java类在独立线程中消费Kafka消息的特定场景中。

Karate创建Graal Context的核心机制 #

• Karate默认会为每个测试场景分配一个独立的GraalVM Polyglot Context，这个上下文与场景执行线程强绑定，不允许跨线程访问。
• GraalJS本身设计为单线程运行环境，对跨线程访问有严格的安全校验，任何跨线程操作JS相关的Polyglot对象都会触发异常。
• 场景中传递的属性Map、内置karate对象等，本质都是隶属于当前场景Graal Context的Polyglot对象，其生命周期和访问权限完全绑定在场景执行线程上。

关于推测的合理性判断 #

你的推测完全成立，原因如下：

• Kafka消费者运行在独立线程中，当它直接读取场景传递的Polyglot Map时，相当于跨线程访问了原场景的GraalJS上下文，触发了GraalJS的单线程访问校验规则，直接抛出异常。
• Polyglot对象的内部方法调用、状态维护都依赖原线程的上下文环境，跨线程操作会破坏其线程安全性，这是GraalVM Polyglot环境的核心限制之一。

解决方案验证 #

你通过将场景配置从默认Polyglot对象复制到HashMap的方式解决问题，是精准命中根源的方案：

• HashMap是Java原生集合类，不依赖GraalJS上下文，也不绑定特定线程，在Kafka消费者线程中访问不会触发跨线程校验。
• 单纯规避JS代码只能减少上下文依赖，但无法彻底解决跨线程访问Polyglot对象的问题，而复制到Java原生集合从根源上切断了对Graal Context的关联。

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