别再手动循环了！用Activiti6.0多实例节点搞定多人审批（附完整Java代码）
Activiti6.0多实例节点实战：告别低效循环，实现优雅会签审批
当团队需要集体决策时，传统的手动循环审批代码就像用算盘处理大数据——既笨拙又容易出错。想象一下部门团建审批场景：财务要审核预算、HR要确认人员、主管要评估时间，每个环节都需要多人参与。Activiti6.0的多实例节点功能，正是为解决这类协作难题而生。
1. 多实例节点核心机制解析
多实例节点的本质是"一任务多执行"模式。与普通任务节点不同，它通过内置的循环引擎自动处理任务分发和结果聚合。就像快递柜的智能分配系统，不需要人工指定每个包裹的位置。
关键内置变量解析：
| 变量名 | 作用域 | 典型用途示例 |
|---|---|---|
| nrOfInstances | 流程实例级别 | 获取总审批人数${nrOfInstances} |
| nrOfActiveInstances | 流程实例级别 | 检查当前活跃任务数 |
| nrOfCompletedInstances | 流程实例级别 | 计算完成比例${nrOfCompletedInstances/nrOfInstances} |
| loopCounter | 任务实例级别 | 获取当前处理人在集合中的索引位置 |
这些变量在运行时由引擎自动维护，开发者无需手动更新。例如在团建审批中，当财务部3人中已有2人同意时，nrOfCompletedInstances会自动变为2。
注意：
loopCounter是任务级变量，不同审批人看到的值不同，不能用于流程级判断
2. 完整会签审批实现路径
2.1 流程定义配置实战
以部门团建审批为例，我们需要在.bpmn文件中定义多实例用户任务：
<userTask id="teamBuildingApproval" name="团建方案会签" activiti:assignee="${approver}"> <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="${approverList}" activiti:elementVariable="approver"> <completionCondition> ${nrOfCompletedInstances/nrOfInstances >= 0.6} </completionCondition> </multiInstanceLoopCharacteristics> </userTask>这段配置实现了：
- 并行会签模式（
isSequential="false"） - 动态审批人列表（
${approverList}变量传入） - 自定义完成条件（60%成员通过即生效）
2.2 Java服务层集成
在Spring Boot项目中启动流程的典型代码：
@Autowired private RuntimeService runtimeService; public void startTeamBuildingProcess(TeamBuildingRequest request) { Map<String, Object> variables = new HashMap<>(); // 设置审批人列表（实际项目可从数据库获取） variables.put("approverList", Arrays.asList( "finance_manager", "hr_director", "dept_leader", "team_leader" )); // 设置其他业务变量 variables.put("budget", request.getBudget()); variables.put("participants", request.getParticipantCount()); ProcessInstance instance = runtimeService.startProcessInstanceByKey( "teamBuildingProcess", variables ); log.info("启动团建审批流程：{}", instance.getId()); }2.3 任务查询与处理
审批人获取待办任务的示例：
public List<Task> getPendingApprovals(String userId) { return taskService.createTaskQuery() .taskAssignee(userId) .processDefinitionKey("teamBuildingProcess") .active() .list(); } public void completeApproval(String taskId, boolean approved) { Map<String, Object> taskVars = new HashMap<>(); taskVars.put("approved", approved); taskService.complete(taskId, taskVars); log.debug("完成任务审批：taskId={}, 结果={}", taskId, approved); }3. 高级应用场景与避坑指南
3.1 动态调整审批人列表
有时需要在流程运行时调整审批人。通过RuntimeService的setVariable方法实现：
public void updateApprovers(String processInstanceId, List<String> newApprovers) { runtimeService.setVariable( processInstanceId, "approverList", newApprovers ); // 注意：已有任务不受影响，只对新生成实例有效 }3.2 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 任务未生成 | collection变量未设置或为空 | 检查流程变量传递 |
| 完成条件不触发 | 表达式语法错误 | 使用activiti:expressionManager测试 |
| 审批人看到重复任务 | 变量作用域冲突 | 确保elementVariable名称唯一 |
| 顺序会签卡住 | 前序任务未完成 | 检查nrOfActiveInstances值 |
3.3 性能优化建议
对于大规模会签（超过50人）：
- 避免在collection中直接存储大量数据
- 考虑分批次处理，使用子流程
- 对
nrOfInstances等变量建立流程索引
// 优化后的批量查询 List<Task> tasks = taskService.createTaskQuery() .processInstanceId(processInstanceId) .taskAssignee(userId) .initializeFormKeys() // 预加载表单 .listPage(0, 100); // 分页处理4. 业务规则与审批策略设计
4.1 多维度审批策略
根据不同业务场景设计完成条件：
<!-- 简单多数通过 --> <completionCondition> ${nrOfCompletedInstances > nrOfInstances/2} </completionCondition> <!-- 关键角色必须同意 --> <completionCondition> ${(nrOfCompletedInstances >= 3) && contains(approvedUsers, 'ceo')} </completionCondition>4.2 混合审批模式实现
结合顺序和并行审批的优势：
<multiInstanceLoopCharacteristics isSequential="true" activiti:collection="${firstPhaseApprovers}"> <!-- 第一阶段顺序审批 --> </multiInstanceLoopCharacteristics> <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="${secondPhaseApprovers}"> <!-- 第二阶段并行审批 --> </multiInstanceLoopCharacteristics>这种模式适合需要先由主管初审，再交由部门全员表决的场景。