jBPM 5.4.0.Final版本BPMN流程偶发任务完成后未触发下一节点问题

问题现象 #

• 任务可正常完成，但下一节点会间歇性不触发；
• 问题随机出现，多数时间运行正常，仅在特定条件下失败；
• 任务完成时无任何异常或错误记录；
• 同一流程实例内的任务被快速连续创建并完成时，问题出现频率更高。

问题根源 #

经排查，问题出在org.jbpm.workflow.instance.node.WorkItemNodeInstance类的workItemCompleted方法中：当前工作项ID（workItemId）保留了流程实例的前一个工作项ID，导致无法进入if代码块，进而跳过了下一节点的创建逻辑。

相关代码片段：

public void workItemCompleted(WorkItem workItem) {
        if ( workItemId == workItem.getId()
                || ( workItemId == -1 && getWorkItem().getId() == workItem.getId()) ) {
            removeEventListeners();
            triggerCompleted(workItem);
        }
}

解决思路与建议 #

1. 修复workItemId的更新逻辑 #

核心问题是workItemId未及时更新为当前工作项的ID，导致后续完成的工作项无法匹配。需要检查WorkItemNodeInstance中初始化或启动工作项的代码（比如internalTrigger方法），确保每次创建新工作项时，workItemId都被正确赋值为当前工作项的ID，而非保留旧值。

示例修正逻辑：

// 在工作项创建完成后立即更新workItemId
WorkItem newWorkItem = createWorkItem();
this.workItemId = newWorkItem.getId();

2. 优化并发场景下的匹配逻辑 #

由于快速连续操作时问题频发，说明存在并发竞争导致的workItemId更新不及时。可以从两方面优化：

• 对workItemCompleted方法添加同步控制，确保同一流程实例的工作项完成操作串行执行，避免ID被覆盖；
• 调整匹配逻辑，维护当前节点的工作项ID集合，只要完成的工作项ID属于该集合，就执行后续的节点触发逻辑，而非依赖单一的workItemId。

3. 升级jBPM版本 #

jBPM 5.4.0.Final是较早的版本，后续5.x补丁版本或更高版本（如6.x、7.x）大概率已经修复了这类并发场景下的工作项匹配bug。升级版本是从根源解决问题的有效方式。

4. 临时规避方案 #

如果暂时无法修改代码或升级版本，可以在业务层做限制：避免同一流程实例内的任务被快速连续完成。比如在任务完成操作之间添加短暂延迟，或者通过队列机制串行化任务完成请求，减少并发冲突的概率。

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