个人随笔
目录
Flowable 工作流的本质:一台状态机,和它"故意不管"的两件事
2026-11-16 23:27:29

如果只用一句话概括 Flowable(以及大多数 BPMN 工作流引擎)的本质:

它是一台状态机,负责让流程按图流转;它不认识”当前登录用户”,也不替你做权限判断。

这句话听着简单,但真正吃透它,能解开工作流开发里大半的困惑。本文从一个真实项目的代码片段讲起。


一、先看一段让人犯疑的代码

这是一个 Spring Boot + Flowable 请假审批项目里,员工”提交申请”的方法:

  1. public void submit(String processInstanceId, String employeeId, String leaderId) {
  2. Task task = taskService.createTaskQuery()
  3. .processInstanceId(processInstanceId)
  4. .taskAssignee(employeeId) // ① 这里用 employeeId 查任务
  5. .singleResult();
  6. if (task == null) {
  7. throw new IllegalStateException("当前用户在此流程中没有待提交的请假申请任务");
  8. }
  9. Map<String, Object> variables = new HashMap<String, Object>();
  10. variables.put("assignee", leaderId == null ? DEFAULT_LEADER : leaderId); // ② 这里又设 assignee
  11. variables.put("leaderId", leaderId == null ? DEFAULT_LEADER : leaderId);
  12. updateStatusIfRunning(processInstanceId, "审批中");
  13. taskService.complete(task.getId(), variables);
  14. }

再看领导审批的方法:

  1. public void leaderApply(String taskId, String bossId) {
  2. Task task = findTask(taskId); // ③ 只按 taskId 查
  3. Map<String, Object> variables = new HashMap<String, Object>();
  4. variables.put("assignee", bossId);
  5. variables.put("result", Boolean.TRUE);
  6. taskService.complete(task.getId(), variables);
  7. }
  8. private Task findTask(String taskId) {
  9. Task task = taskService.createTaskQuery().taskId(taskId).singleResult();
  10. if (task == null) {
  11. throw new IllegalStateException("任务不存在或已办理:" + taskId);
  12. }
  13. return task;
  14. }

三个疑问自然浮现:

  1. employeeId 是干什么的?
  2. variables.put("assignee", leaderId) 是不是在指定”下一个审批人”?
  3. 为什么员工提交要按人查,领导审批却只按任务 ID 查——引擎是不是根本不校验谁能审批?

把这三个问题回答清楚,工作流的底层逻辑就通了。


二、本质一:assignee 是一根”接力棒”

先看 BPMN 流程定义里的三个用户任务:

  1. <userTask name="请假申请" flowable:assignee="${assignee}"/>
  2. <userTask name="领导审批" flowable:assignee="${assignee}"/>
  3. <userTask name="老板审批" flowable:assignee="${assignee}"/>

注意:三个节点的办理人写的是同一个表达式 ${assignee},引用的是同一个流程变量。

引擎在流转进入某个用户任务时,会解析 ${assignee},取当前流程变量 assignee 的值,写进这个任务的 ASSIGNEE_ 字段。于是 assignee 就成了一根贯穿全流程的接力棒:

时机 设置的 assignee 效果
启动流程 员工 ID “请假申请”任务归员工
员工 submit leaderId 流转到”领导审批”,办理人变领导
领导 leaderApply bossId 流转到”老板审批”,办理人变老板
领导/老板驳回 employeeId 退回”请假申请”,办理人又变回员工
  1. flowchart LR
  2. A["① 请假申请<br/>assignee = 员工 1000"] -->|"complete 前设<br/>assignee = leaderId"| B["② 领导审批<br/>assignee = 领导 2000"]
  3. B -->|"complete 前设<br/>assignee = bossId"| C["③ 老板审批<br/>assignee = 老板 3000"]
  4. 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 签名:

  1. 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 字段是否可信
变量在流程上下文中的传递 业务数据校验

结论:工作流保证”流程按规矩走”,不保证”操作的人是对的”。


四、项目里的真实现状:两条路径,两种校验

理解了这个边界,再回头看项目代码,一切就说得通了。审批其实有两条入口:

  1. flowchart LR
  2. subgraph 页面路径
  3. P1["表单提交<br/>session 取当前用户"] --> P2{"findOwnTask<br/>查本人待办列表"}
  4. P2 -->|找到| OK["complete 引擎流转"]
  5. P2 -->|找不到| DENY["拒绝:不在您的待办中"]
  6. end
  7. subgraph REST 路径
  8. R1["GET /leaderApply/{taskId}"] --> R2["findTask<br/>只查任务是否存在"]
  9. R2 --> OK
  10. end

页面路径(PageController)在调用引擎前做了校验:

  1. TaskVo task = findOwnTask(taskId, currentUser(session).getId());
  2. private TaskVo findOwnTask(String taskId, String assignee) {
  3. for (TaskVo vo : workflowService.todoList(assignee)) { // 查当前用户的待办
  4. if (taskId.equals(vo.getTaskId())) {
  5. return vo;
  6. }
  7. }
  8. throw new IllegalStateException("该任务不在您的待办列表中");
  9. }

先查”当前用户”的待办列表,确认这个 taskId 在其中,才允许操作——这才是真正的防越权闸门。

REST 路径(FlowableTestController)则直接把 taskId 传给引擎:

  1. @GetMapping("/leaderApply/{taskId}/{bossId}")
  2. public Result<?> leaderApply(@PathVariable("taskId") String taskId,
  3. @PathVariable("bossId") String bossId) {
  4. workflowService.leaderApply(taskId, bossId); // 没有身份校验
  5. return Result.ok("领导审批通过");
  6. }

任何登录用户只要知道 taskId,就能替别人审批。这是原文 demo 的写法——适合演示流程本身,生产环境必须补上校验。

至于开头员工的 .taskAssignee(employeeId),它其实是一举两得:既定位”我要提交的那张申请单”,又顺带实现了”只能提交自己的申请”。


五、正确的防越权写法

把身份作为查询条件,查不到就拒绝:

  1. public void leaderApply(String taskId, String bossId, String currentUserId) {
  2. Task task = taskService.createTaskQuery()
  3. .taskId(taskId)
  4. .taskAssignee(currentUserId) // 关键:身份参与查询
  5. .singleResult();
  6. if (task == null) {
  7. throw new AccessDeniedException("该任务不属于当前用户");
  8. }
  9. // ... 设置变量 ...
  10. taskService.complete(task.getId(), variables);
  11. }

如果是候选组模式(多人可认领同一个任务),则用 taskCandidateGroup(...) 校验用户所属组,再调用 claim() 认领。但同样要注意:claim() 本身也不校验身份,是否属于该组仍需业务代码判断。

还有一个常见误区:以为用了 Flowable 自带的 IdentityService(user / group / membership 那套表)引擎就会自动鉴权。不会——那些也只是数据表,你不主动查,引擎绝不替你拦截。


六、总结:三条心法

  1. 工作流 = 状态机。 它保证流程按 BPMN 正确流转、变量正确传递、历史正确留痕;仅此而已。
  2. assignee 是流程数据,不是安全边界。 它是一根接力棒、一个收件人标签,谁完成任务谁负责把它交给下一任。
  3. 权限是应用层的责任。 所有敏感操作前,都必须用”当前登录用户”作为查询条件或显式判断,查不到就拒绝——引擎永远不会替你做这件事。

把这三句话记住,再看任何工作流框架的 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 — 请假审批流程定义
 2

啊!这个可能是世界上最丑的留言输入框功能~


当然,也是最丑的留言列表

有疑问发邮件到 : suibibk@qq.com 侵权立删
Copyright : 个人随笔   备案号 : 粤ICP备18099399号-2