Camunda 7多流程实例并行执行时变量竞态条件问题排查

1. Groovy脚本类的共享状态污染 #

Camunda中Groovy脚本任务的类加载器默认全局共享。如果在脚本里定义Result类，该类会被加载到共享类加载器中，其静态成员、类级状态会被所有并行执行的流程实例共享。单实例运行时无冲突，但多实例并行时，多个流程会同时修改共享状态，导致变量实例混乱、NPE（比如某个实例的Result对象未正确初始化就被调用）。

2. 流程变量的并发冲突 #

• 若Result实例未按流程实例隔离，多个并行流程会共享同一个对象，调用setSuccess/setError时发生并发修改，导致变量状态异常。
• 子流程访问父变量时，若误在子流程作用域创建同名变量，会触发ENGINE-17004（变量已存在）异常；或因共享类实例导致变量创建逻辑重复执行，试图重复初始化同一变量。

3. NullPointerException 触发场景 #

当并行流程共享Result类的静态状态时，某个流程实例的Result对象可能被其他实例覆盖为null，或Init方法未在当前实例的对象上执行，导致子流程调用方法时触发NPE。

1. 隔离流程实例的Result对象 #

方案A：用Map替代自定义类（最简单） #

放弃在Groovy脚本中定义Result类，直接用Groovy的Map存储状态，每个流程实例创建独立的Map：

// 父流程脚本任务初始化
def result = [success: false, errorMsg: ""]
execution.setVariable("parentResult", result)

// 子流程标记成功
def parentResult = execution.getVariable("parentResult")
parentResult.success = true

// 子流程标记错误
def parentResult = execution.getVariable("parentResult")
parentResult.errorMsg = "具体错误信息"

Map是轻量级结构，每个流程实例的Map都是独立对象，完全避免类加载共享问题。

方案B：确保自定义类实例隔离 #

如果必须使用Result类，不要在脚本中定义类（避免共享类加载），将Result类编译为Java类，放到Camunda的lib目录或部署包的classes目录中，然后在脚本中为每个流程实例创建独立对象：

// 父流程脚本任务
import com.yourpackage.Result
def result = new Result()
result.init()
execution.setVariable("parentResult", result)

这样每个流程实例的Result对象都是独立的，不会共享状态。

2. 规范变量访问逻辑 #

• 子流程访问父变量时，仅读取父作用域的变量，不要在子流程中调用setVariable设置同名变量（避免触发ENGINE-17004）。
• 确保Init方法仅在当前流程实例的Result对象上执行，不要依赖类的静态方法初始化。

3. 并行创建实例的客户端规范 #

C#代码并行创建流程实例时，确保每个请求的变量参数独立创建，不要在客户端复用变量对象。例如，每个并行任务都生成自己的变量字典，避免客户端层面的状态共享。

4. 检查流程变量作用域 #

在Camunda Modeler中确认：

• parentResult变量在父流程的作用域创建（脚本任务属于父流程）。
• 子流程通过父作用域变量访问parentResult，而非在子流程内重新定义同名变量。

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