如果只用一句话概括 Flowable(以及大多数 BPMN 工作流引擎)的本质:
它是一台状态机,负责让流程按图流转;它不认识”当前登录用户”,也不替你做权限判断。
这句话听着简单,但真正吃透它,能解开工作流开发里大半的困惑。本文从一个真实项目的代码片段讲起。
一、先看一段让人犯疑的代码
这是一个 Spring Boot + Flowable 请假审批项目里,员工”提交申请”的方法:
public void submit(String processInstanceId, String employeeId, String leaderId) {Task task = taskService.createTaskQuery().processInstanceId(processInstanceId).taskAssignee(employeeId) // ① 这里用 employeeId 查任务.singleResult();if (task == null) {throw new IllegalStateException("当前用户在此流程中没有待提交的请假申请任务");}Map<String, Object> variables = new HashMap<String, Object>();variables.put("assignee", leaderId == null ? DEFAULT_LEADER : leaderId); // ② 这里又设 assigneevariables.put("leaderId", leaderId == null ? DEFAULT_LEADER : leaderId);updateStatusIfRunning(processInstanceId, "审批中");taskService.complete(task.getId(), variables);}
再看领导审批的方法:
public void leaderApply(String taskId, String bossId) {Task task = findTask(taskId); // ③ 只按 taskId 查Map<String, Object> variables = new HashMap<String, Object>();variables.put("assignee", bossId);variables.put("result", Boolean.TRUE);taskService.complete(task.getId(), variables);}private Task findTask(String taskId) {Task task = taskService.createTaskQuery().taskId(taskId).singleResult();if (task == null) {throw new IllegalStateException("任务不存在或已办理:" + taskId);}return task;}
三个疑问自然浮现:
employeeId是干什么的?variables.put("assignee", leaderId)是不是在指定”下一个审批人”?- 为什么员工提交要按人查,领导审批却只按任务 ID 查——引擎是不是根本不校验谁能审批?
把这三个问题回答清楚,工作流的底层逻辑就通了。
二、本质一:assignee 是一根”接力棒”
先看 BPMN 流程定义里的三个用户任务:
<userTask name="请假申请" flowable:assignee="${assignee}"/><userTask name="领导审批" flowable:assignee="${assignee}"/><userTask name="老板审批" flowable:assignee="${assignee}"/>
注意:三个节点的办理人写的是同一个表达式 ${assignee},引用的是同一个流程变量。
引擎在流转进入某个用户任务时,会解析 ${assignee},取当前流程变量 assignee 的值,写进这个任务的 ASSIGNEE_ 字段。于是 assignee 就成了一根贯穿全流程的接力棒:
| 时机 | 设置的 assignee |
效果 |
|---|---|---|
| 启动流程 | 员工 ID | “请假申请”任务归员工 |
| 员工 submit | leaderId |
流转到”领导审批”,办理人变领导 |
| 领导 leaderApply | bossId |
流转到”老板审批”,办理人变老板 |
| 领导/老板驳回 | employeeId |
退回”请假申请”,办理人又变回员工 |
flowchart LRA["① 请假申请<br/>assignee = 员工 1000"] -->|"complete 前设<br/>assignee = leaderId"| B["② 领导审批<br/>assignee = 领导 2000"]B -->|"complete 前设<br/>assignee = bossId"| C["③ 老板审批<br/>assignee = 老板 3000"]C -->|"驳回:assignee = employeeId"| A
所以第二个问题的答案是:是的,variables.put("assignee", leaderId) 就是在指定下一节点的处理人。
但要注意两个细节:
- 它指定的是”下一节点的办理人“,不是”下一节点”。走哪条分支是
result、day这些变量配合网关条件决定的(${result == true}、${day >= 2}),assignee只管”谁来处理”。 - 正因所有节点共用一个变量,每一任办理人完成任务前都必须重设
assignee,否则下一节点会沿用上一任的人,任务就”卡”在一个人手里了。这就是驳回时要把assignee改回employeeId的原因。
职责分离:两类变量各管各的
| 变量 | 性质 | 作用 | 是否稳定 |
|---|---|---|---|
assignee |
技术变量 | 引擎据此决定任务办理人,被反复覆盖 | 每流转一次就变 |
employeeId / leaderId / bossId |
业务变量 | 记录”谁请假、指派给谁、谁审批”,供追溯查询 | 全程稳定 |
day / result |
路由变量 | 配合网关条件决定流程走向 | 按业务写入 |
当前项目里 leaderId 和 assignee 被赋了相同的值,但职责完全不同:assignee 是”此刻谁办”,leaderId 是”这个流程指派的领导是谁”。
三、本质二:引擎不认识”当前登录用户”
这是最容易被误解、也最关键的一点。
看一眼引擎的核心 API 签名:
taskService.complete(String taskId, Map<String, Object> variables);
参数里根本没有”当前用户”这一项。 这不是 API 设计疏漏,而是刻意为之:
- Flowable 是嵌入式引擎,跑在你自己的 JVM 里,它不知道你的应用有没有登录态、Session 长什么样、权限模型是什么;
- 所以
complete()只关心:这个taskId存不存在、任务是不是挂起了、然后按连线把流程往前推; - 它永远不会拿”调用者身份”和
assignee字段做比对。
进一步说,assignee 只是 ACT_RU_TASK 表里一个普通的 VARCHAR 字段:
- 任何人都能用
taskService.setAssignee(taskId, "张三")改掉它,引擎不拦; - 你甚至可以不查任务,直接
complete(任意taskId)——只要 ID 合法,照样完成。
那引擎到底保证什么?
| 引擎负责(状态正确性) | 引擎不负责(业务/安全) |
|---|---|
| 按 BPMN 连线流转、网关条件判断 | 调用者是谁 |
| 一个任务只能完成一次、并发乐观锁 | 这个人有没有权限审批 |
| 流程挂起/激活、历史留痕 | assignee 字段是否可信 |
| 变量在流程上下文中的传递 | 业务数据校验 |
结论:工作流保证”流程按规矩走”,不保证”操作的人是对的”。
四、项目里的真实现状:两条路径,两种校验
理解了这个边界,再回头看项目代码,一切就说得通了。审批其实有两条入口:
flowchart LRsubgraph 页面路径P1["表单提交<br/>session 取当前用户"] --> P2{"findOwnTask<br/>查本人待办列表"}P2 -->|找到| OK["complete 引擎流转"]P2 -->|找不到| DENY["拒绝:不在您的待办中"]endsubgraph REST 路径R1["GET /leaderApply/{taskId}"] --> R2["findTask<br/>只查任务是否存在"]R2 --> OKend
页面路径(PageController)在调用引擎前做了校验:
TaskVo task = findOwnTask(taskId, currentUser(session).getId());private TaskVo findOwnTask(String taskId, String assignee) {for (TaskVo vo : workflowService.todoList(assignee)) { // 查当前用户的待办if (taskId.equals(vo.getTaskId())) {return vo;}}throw new IllegalStateException("该任务不在您的待办列表中");}
先查”当前用户”的待办列表,确认这个 taskId 在其中,才允许操作——这才是真正的防越权闸门。
REST 路径(FlowableTestController)则直接把 taskId 传给引擎:
@GetMapping("/leaderApply/{taskId}/{bossId}")public Result<?> leaderApply(@PathVariable("taskId") String taskId,@PathVariable("bossId") String bossId) {workflowService.leaderApply(taskId, bossId); // 没有身份校验return Result.ok("领导审批通过");}
任何登录用户只要知道 taskId,就能替别人审批。这是原文 demo 的写法——适合演示流程本身,生产环境必须补上校验。
至于开头员工的 .taskAssignee(employeeId),它其实是一举两得:既定位”我要提交的那张申请单”,又顺带实现了”只能提交自己的申请”。
五、正确的防越权写法
把身份作为查询条件,查不到就拒绝:
public void leaderApply(String taskId, String bossId, String currentUserId) {Task task = taskService.createTaskQuery().taskId(taskId).taskAssignee(currentUserId) // 关键:身份参与查询.singleResult();if (task == null) {throw new AccessDeniedException("该任务不属于当前用户");}// ... 设置变量 ...taskService.complete(task.getId(), variables);}
如果是候选组模式(多人可认领同一个任务),则用 taskCandidateGroup(...) 校验用户所属组,再调用 claim() 认领。但同样要注意:claim() 本身也不校验身份,是否属于该组仍需业务代码判断。
还有一个常见误区:以为用了 Flowable 自带的 IdentityService(user / group / membership 那套表)引擎就会自动鉴权。不会——那些也只是数据表,你不主动查,引擎绝不替你拦截。
六、总结:三条心法
- 工作流 = 状态机。 它保证流程按 BPMN 正确流转、变量正确传递、历史正确留痕;仅此而已。
assignee是流程数据,不是安全边界。 它是一根接力棒、一个收件人标签,谁完成任务谁负责把它交给下一任。- 权限是应用层的责任。 所有敏感操作前,都必须用”当前登录用户”作为查询条件或显式判断,查不到就拒绝——引擎永远不会替你做这件事。
把这三句话记住,再看任何工作流框架的 API,都会有一眼见底的感觉:先分清哪些是引擎的状态职责,哪些是你的业务职责,架构自然就清晰了。
文中代码来自示例项目
flowable-study(Spring Boot 2.7.2 + Flowable 6.7.2):
service/WorkflowService.java— 流程操作与assignee接力逻辑controller/PageController.java— 带身份校验的页面审批路径controller/FlowableTestController.java— 原文 15 个 REST 接口(无身份校验,仅演示用)resources/processes/leave.bpmn20.xml— 请假审批流程定义
