Camunda工作流多实例实战：会签与多人审批的配置与优化
1. 理解Camunda多实例工作流的核心概念
第一次接触Camunda多实例配置时，我被"会签"这个概念卡住了三天。当时项目急着上线，客户要求实现一个采购审批流程：5个部门负责人需要全部签字才能生效。传统做法可能要创建5个独立任务节点，而Camunda的多实例特性让这个需求变得异常简单。
**多实例(Multi-instance)**本质上是BPMN规范中的一种特殊活动类型，它允许单个任务节点被动态复制多次。在实际业务中，最常见的两种场景就是会签（多人审批）和任务分发。与普通任务节点不同，多实例节点有三个关键特征：
- 动态实例生成：根据输入集合（如审批人列表）自动创建对应数量的任务实例
- 执行模式可选：支持顺序执行（串行）或并行执行
- 智能完成判断：通过条件表达式控制流程何时继续向下流转
我特别喜欢Camunda实现多实例的方式——用可视化属性配置代替硬编码。在流程设计器中，只需要在任务节点上勾选"Multi-instance"选项，然后配置几个关键参数就能实现复杂的分支逻辑。这比传统编码方式至少节省60%的开发时间。
2. 多实例的两种执行模式详解
2.1 顺序执行模式（Sequential）
去年给某金融机构做OA系统时，他们有个特殊需求：财务审批必须按照"会计→主管→总监"的严格顺序进行。这种场景就是顺序执行模式的典型用例。
配置顺序会签只需要三步：
- 在BPMN图中选中审批节点
- 设置Multi-instance Type为Sequential
- 指定审批人集合（如accountantList）
对应的Java代码示例：
// 获取审批人列表（按审批顺序） List<String> approvers = Arrays.asList("user1", "user2", "user3"); Map<String, Object> variables = new HashMap<>(); variables.put("approverList", approvers); runtimeService.startProcessInstanceByKey( "financial_approval", businessKey, variables );这种模式有个隐藏的坑需要注意：如果前序审批人长时间不处理任务，整个流程会被阻塞。我们在生产环境就遇到过会计请假导致流程卡死的情况。后来通过设置任务超时自动转交解决了这个问题。
2.2 并行执行模式（Parallel）
电商平台的退款审核流程是我用过最典型的并行案例。当用户申请大额退款时，需要风控、财务、客服三个部门同时审核，谁先完成都不影响其他人。
并行模式的配置更简单：
- 保持Multi-instance Type为Parallel（默认值）
- 定义参与者集合
- 设置完成条件（如全部通过）
对应的XML配置片段：
<userTask id="parallelApproval" name="并行审批"> <multiInstanceLoopCharacteristics isSequential="false" camunda:collection="${departmentList}" camunda:elementVariable="approver"> <completionCondition>${nrOfCompletedInstances/nrOfInstances >= 0.6}</completionCondition> </multiInstanceLoopCharacteristics> </userTask>这里我用了60%通过率的条件表达式，这是实际项目中很实用的技巧——不需要全员同意，只要多数通过即可。特别适合大型组织的民主决策场景。
3. 多实例的核心配置参数
3.1 实例数量控制
Camunda提供了两种方式来控制实例数量，我在不同场景下会灵活选择：
| 配置方式 | 适用场景 | 示例 | 注意事项 |
|---|---|---|---|
| Loop Cardinality | 固定数量的审批 | <loopCardinality>5</loopCardinality> | 数字需硬编码 |
| Collection | 动态变化的审批人列表 | camunda:collection="${approverList}" | 需要提前设置集合变量 |
实际项目中，我90%的情况都会用Collection方式，因为它更灵活。比如从数据库查询当前在岗的部门经理作为审批人：
List<String> managers = departmentService.findActiveManagers(); variables.put("approverList", managers);3.2 完成条件表达式
完成条件(Completion Condition)是多实例最强大的功能之一，这些是我积累的实用表达式：
- 全票通过：
${nrOfCompletedInstances == nrOfInstances} - 一票否决：
${nrOfCompletedInstances > 0 && nrOfRejectedInstances > 0} - 比例通过：
${nrOfApprovedInstances/nrOfInstances >= 0.7} - 首票决定：
${firstApproverDecision == 'REJECT'}
注意表达式中的变量需要与流程变量配合使用。比如要实现"一票否决"，需要在每个审批任务结束时更新拒绝计数：
taskService.complete(taskId, Variables.putValue("rejected", true));4. 性能优化实战技巧
4.1 批量操作优化
当并行审批人数超过50人时，数据库压力会明显增大。我们通过三种方式优化：
- 启用批量处理：在camunda.cfg.xml中配置
<property name="jdbcBatchProcessing">true</property>- 调整事务批次大小：
ProcessEngineConfiguration.create() .setJdbcBatchSize(30);- 异步延续：在多实例节点上添加async属性
<userTask id="massApproval" camunda:asyncBefore="true">实测这些优化能让千人规模的会签流程执行时间从15秒降到3秒内。
4.2 历史数据清理
多实例流程会产生大量历史任务记录，我们的运维策略是：
- 保留最近3个月的详细历史
- 压缩存储3-12个月的概要历史
- 删除1年以上的历史数据
配置示例：
-- 设置历史清理周期 UPDATE ACT_RU_TASK SET HISTORY_REMOVAL_TIME_ = NOW() + INTERVAL 90 DAY WHERE PROC_DEF_ID_ = 'processId';5. 常见问题排查指南
去年实施某政府项目时，我们遇到了一个典型问题：并行会签任务偶尔会重复分配。经过排查发现是集合变量被并发修改导致的。解决方案是：
- 使用不可变集合：
variables.put("approverList", Collections.unmodifiableList(approvers));- 或者在流程启动前克隆集合：
List<String> safeList = new ArrayList<>(originalList);其他常见问题包括：
- 集合变量为空：在网关处添加空值检查
- 元素变量冲突：确保elementVariable名称唯一
- 条件表达式失效：检查变量作用域是否正确
记得每次修改多实例配置后，最好清空ACT_RU表的相关测试数据，避免缓存导致的行为不一致。