别再手动循环了！用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 idteamBuildingApproval name团建方案会签 activiti:assignee${approver} multiInstanceLoopCharacteristics isSequentialfalse activiti:collection${approverList} activiti:elementVariableapprover completionCondition ${nrOfCompletedInstances/nrOfInstances 0.6} /completionCondition /multiInstanceLoopCharacteristics /userTask这段配置实现了并行会签模式isSequentialfalse动态审批人列表${approverList}变量传入自定义完成条件60%成员通过即生效2.2 Java服务层集成在Spring Boot项目中启动流程的典型代码Autowired private RuntimeService runtimeService; public void startTeamBuildingProcess(TeamBuildingRequest request) { MapString, 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 ListTask getPendingApprovals(String userId) { return taskService.createTaskQuery() .taskAssignee(userId) .processDefinitionKey(teamBuildingProcess) .active() .list(); } public void completeApproval(String taskId, boolean approved) { MapString, 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, ListString newApprovers) { runtimeService.setVariable( processInstanceId, approverList, newApprovers ); // 注意已有任务不受影响只对新生成实例有效 }3.2 常见问题排查表现象可能原因解决方案任务未生成collection变量未设置或为空检查流程变量传递完成条件不触发表达式语法错误使用activiti:expressionManager测试审批人看到重复任务变量作用域冲突确保elementVariable名称唯一顺序会签卡住前序任务未完成检查nrOfActiveInstances值3.3 性能优化建议对于大规模会签超过50人避免在collection中直接存储大量数据考虑分批次处理使用子流程对nrOfInstances等变量建立流程索引// 优化后的批量查询 ListTask 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)} /completionCondition4.2 混合审批模式实现结合顺序和并行审批的优势multiInstanceLoopCharacteristics isSequentialtrue activiti:collection${firstPhaseApprovers} !-- 第一阶段顺序审批 -- /multiInstanceLoopCharacteristics multiInstanceLoopCharacteristics isSequentialfalse activiti:collection${secondPhaseApprovers} !-- 第二阶段并行审批 -- /multiInstanceLoopCharacteristics这种模式适合需要先由主管初审再交由部门全员表决的场景。