Activiti7 会签多实例任务实战：动态审批人、一票否决与网关路由详解-程序员充电站

1. 会签多实例任务的核心概念

会签是工作流中常见的审批场景，多个审批人需要同时对同一事项进行审批。在Activiti7中，这种需求可以通过多实例任务来实现。简单来说，就是把一个任务复制成多份，分发给不同的审批人。

想象一下公司采购申请的审批流程：财务、法务、技术三个部门需要同时审核。传统串行审批需要等前一个部门完成才能到下一个，而会签模式下三个部门可以同时处理，效率提升明显。

Activiti7的多实例任务实现依赖于三个关键属性：

collection：审批人集合，比如["财务","法务","技术"]
elementVariable：当前处理的审批人变量名
completionCondition：任务完成条件

实际项目中我遇到过这样的坑：忘记设置elementVariable导致任务无法分配。正确的做法应该像这样配置：

<multiInstanceLoopCharacteristics activiti:collection="approvers" activiti:elementVariable="approver"> <completionCondition>${nrOfCompletedInstances/nrOfInstances >= 0.6}</completionCondition> </multiInstanceLoopCharacteristics>

2. 动态设置审批人实战

静态配置审批人的方式在实际开发中基本不可行，因为审批人可能来自组织架构、角色配置或特定业务规则。通过RuntimeService传递动态审批人集合才是正确姿势。

最近给客户做OA系统时，我们是这样实现的：先通过组织架构接口获取部门经理列表，再结合业务规则过滤出最终审批人。核心代码如下：

// 获取动态审批人列表 List<String> approvers = orgService.getDepartmentManagers(deptId); // 添加业务规则筛选 approvers = approvers.stream() .filter(u -> !conflictCheckService.hasConflict(u, businessId)) .collect(Collectors.toList()); // 启动流程时传入变量 Map<String, Object> vars = new HashMap<>(); vars.put("approvers", approvers); vars.put("approverCount", approvers.size()); runtimeService.startProcessInstanceByKey("multiApprove", vars);

特别注意：当审批人列表为空时需要特殊处理。我们的做法是添加默认审批人并记录告警日志，避免流程卡死。

3. 一票否决机制的实现

一票否决是会签流程的关键特性。在Activiti中可以通过两种方式实现：

完成条件表达式：

<completionCondition> ${rejected || nrOfCompletedInstances == nrOfInstances} </completionCondition>

执行监听器动态干预：

public class RejectListener implements ExecutionListener { @Override public void notify(DelegateExecution execution) { String comment = (String)execution.getVariable("comment"); if("reject".equals(comment)){ execution.setVariable("rejected", true); // 强制终止其他实例 runtimeService.deleteMultiInstanceExecution( execution.getId(), false); } } }

实测发现第一种方式更简洁，但第二种更灵活。比如我们有个项目需要在否决时自动发送加急通知，就只能用监听器实现。

4. 网关路由的智能判断

会签完成后通常需要根据结果路由到不同分支。排他网关（Exclusive Gateway）配合条件表达式是最佳选择。这里分享几个实用技巧：

条件表达式优化：

<conditionExpression xsi:type="tFormalExpression"> <!-- 更健壮的判断逻辑 --> ${!rejected && approvedCount > 0} </conditionExpression>

常见问题排查：

表达式返回null会导致流程挂起
变量作用域问题（建议使用execution.setVariable）
类型转换异常（字符串和布尔值比较要特别注意）

在最近的项目中，我们封装了安全的条件表达式工具类：

public class ExpressionUtil { public static boolean safeEval(DelegateExecution exec, String expr) { try { Object result = runtimeService .createConditionEvaluation(exec) .evaluate(expr); return Boolean.TRUE.equals(result); } catch (Exception e) { log.warn("表达式执行失败", e); return false; } } }

5. 完整实现案例解析

结合上述知识点，我们来看一个生产级实现。这个案例包含以下特性：

动态审批人设置
一票否决机制
智能路由判断
审批意见收集

流程定义关键部分：

<userTask id="multiApprove" name="会签审批"> <multiInstanceLoopCharacteristics activiti:collection="${approvers}" activiti:elementVariable="currentApprover"> <completionCondition> ${rejected || nrOfCompletedInstances == nrOfInstances} </completionCondition> </multiInstanceLoopCharacteristics> <extensionElements> <activiti:formProperty id="comment" /> <activiti:executionListener event="end" class="com.example.RejectListener"/> </extensionElements> </userTask> <exclusiveGateway id="decisionGateway" /> <sequenceFlow sourceRef="decisionGateway" targetRef="rejectTask"> <conditionExpression>${rejected}</conditionExpression> </sequenceFlow> <sequenceFlow sourceRef="decisionGateway" targetRef="nextStep"> <conditionExpression>${!rejected}</conditionExpression> </sequenceFlow>

监听器实现要点：

public class RejectListener implements ExecutionListener { @Override public void notify(DelegateExecution exec) { String comment = (String)exec.getVariable("comment"); if(comment != null && comment.contains("拒绝")){ // 设置否决标志 exec.setVariable("rejected", true); // 记录否决人 String rejecter = (String)exec.getVariable("currentApprover"); exec.setVariable("rejecter", rejecter); // 发送实时通知 notifyService.sendRejectAlert(rejecter); } } }

这个方案在某大型企业的合同审批流程中稳定运行了2年多，日均处理3000+流程实例。关键优化点在于：

使用异步监听器处理通知逻辑
添加了完备的日志记录
对边界条件做了充分处理

6. 性能优化与常见问题

在大规模使用会签任务时，我们踩过不少性能坑。这里分享几个关键优化点：

审批人集合优化：

控制审批人数量（建议不超过20人）
使用缓存减少组织架构查询
分批处理超大规模审批

数据库优化：

-- 添加必要的索引 CREATE INDEX idx_act_ru_exec_mi ON act_ru_execution(proc_inst_id_, is_mi_root_); -- 定期清理历史数据

常见问题解决方案：

任务卡住：检查nrOfInstances和nrOfActiveInstances是否一致
网关不触发：确认条件表达式变量已正确设置
监听器不执行：检查event类型是否匹配（start/end）

在最近一次性能调优中，我们通过以下改动将处理速度提升了5倍：

将同步监听器改为异步
优化变量存储（大对象存MongoDB）
添加流程实例缓存

7. 扩展应用场景

会签模式不仅适用于审批流程，还可以灵活应用于这些场景：

技术评审：

代码审查多人并行评审
测试用例多人验证
架构设计多方确认

业务场景：

采购多方比价
合同多方签署
项目多方验收

最近我们实现了一个创新的应用：在DevOps流程中使用会签任务控制发布流程。当多个系统需要同时发布时，各系统负责人并行确认准备状态，全部就绪后自动触发发布。关键实现点在于动态设置审批人为各系统负责人，并设置超时自动通过机制。

// 动态设置超时自动通过 timerService.schedule(new Runnable(){ public void run(){ if(!taskService.createTaskQuery() .processInstanceId(procId) .unfinished().list().isEmpty()){ // 自动完成所有任务 tasks.forEach(t -> taskService.complete(t.getId(), autoApproveVars)); } } }, 2, TimeUnit.HOURS);