Karate从0.9.6升级至1.1.0触发JS多线程访问报错如何处理

问题属性 #

该报错属于Karate 1.0到1.1版本区间的已知兼容性问题，根因是1.x版本将底层JS引擎从Nashorn替换为GraalJS后，GraalJS默认禁止多线程并发访问同一个JS执行上下文，而0.9.6版本的Nashorn引擎没有该限制，因此旧版用例迁移到1.1.0版本后，在多线程并行执行场景下会随机触发如下报错：

Multi threaded access requested by thread Thread[pool-2-thread-1,5,main] but is not allowed for language(s) js.

你提到的几个报错场景都是该问题的典型触发场景：

• * configure headers = { cache-control: 'no-cache' , Accept: 'application/fhir+json' }：多线程下多个用例同时修改共享上下文的header配置
• * def authToken = callonce read('classpath:com/company/tests/token/AuthToken.feature')：公共feature被多线程并发调用，触发同一份JS资源的多线程访问
• And header Access-Control-Request-Headers = 'Content-Type'：用例执行时并发修改上下文的header参数

解决方案 #

方案一：升级Karate版本（优先推荐） #

直接将Karate版本升级到1.2.0及以上版本即可解决，官方已经在1.2.0版本中优化了GraalJS上下文的隔离逻辑，默认给每个执行线程分配独立的JS上下文，该类随机报错会直接消失。

方案二：低版本兼容配置（暂时无法升级时使用） #

如果当前项目有依赖限制无法升级版本，可通过以下方式规避：

1. 强制切换回旧版JS引擎
   在项目的karate-config.js文件首行添加如下配置：

karate.configure('jsEngine', 'nashorn');

切换回0.9.6版本使用的Nashorn引擎后，完全兼容原有代码逻辑，不会再触发多线程访问限制报错。
2. 调整公共逻辑位置
将所有全局configure配置、callonce调用的公共feature、公共header设置统一放到karate-config.js中执行，不要分散在各个Feature文件的Background步骤中，避免多线程下的并发上下文修改冲突。
3. 调低并行执行数
如果开启了用例多线程并行执行，暂时将并行数调整到<=4，可大幅降低报错触发概率。

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