深入解析Flowable工作流引擎：从原理到实践

shepherd1112025-09-03 16:54

1.概述

最近在研究工作流功能，所以趁此机会在这里深入了解下工作流相关知识点和流程引擎开源框架。工作流也可以叫审批流，在当下互联网快速发展和自动化办公的背景下，有很多业务场景都是需要走流程审批的，比如说日常的请假流程：提交申请→领导审批→通过或拒绝→抄送人事→结束。那到底什么是工作流呢？

工作流是什么？

工作流是对工作流程及其各操作步骤之间业务规则的抽象、概括描述。工作流建模，即将工作流程中的工作如何前后组织在一起的逻辑和规则，在计算机中以恰当的模型表达并对其实施计算。工作流要解决的主要问题是：为实现某个业务目标，利用计算机在多个参与者之间按某种预定规则自动传递文档、信息或者任务。简单来说，工作流就是对业务的流程化抽象。

开源的工作流引擎很多，比如 activiti、Flowable、Camunda 等，后两个都是基于activiti分叉出来开发的，所以这些框架都是同宗同源的，研究一个即可，其他的使用套路，实现原理都是差不多的。这里就来聊聊当下使用较多，比较主流框架：Flowable

2.Flowable核心概念和原理

Flowable是一个基于Apache 2.0许可证的开源工作流引擎，源自Activiti项目分支。它实现了BPMN 2.0规范，提供了完整的流程定义、执行和监控能力。

BPMN(Bussiness Process Model Notation)：业务流程管理和符号, 简单来说就是工作流模型，是一种流行的业务流程建模语言。它是为业务流程建模而设计的，用于支持业务流程管理，包括分析、设计、优化和实施。通过提供易于理解的、视觉化的图形表示法，使得非技术性的业务人员也能很好地理解业务过程。

下面是Flowable官网的核心api架构图：

服务接口 职责说明 典型方法示例
RepositoryService 流程定义和部署管理 deploy(), createDeployment()
RuntimeService 流程运行时控制 startProcessInstanceByKey()
TaskService 用户任务操作 complete(), claim()
HistoryService 历史数据查询 createHistoricTaskInstanceQuery()
ManagementService 引擎管理和维护 executeCustomSql()

ProcessEngine：整个Flowable引擎的核心入口，通过它可以获取所有Service

ini 复制代码 
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RuntimeService runtimeService = processEngine.getRuntimeService();

核心流程：

3.Spring Boot整合实战

3.1 依赖配置

xml 复制代码 
<dependency>
    <groupId>org.flowable</groupId>
    <artifactId>flowable-spring-boot-starter</artifactId>
    <version>6.7.2</version>
</dependency>

3.2 流程模型定义

设计一个请假流程如下图所示：

在服务的资源文件resources下新建一个processes目录，然后定义一个流程文件：leave-process.bpmn20.xml:

ini 复制代码 
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef">
    <process id="leave-process" name="leave-process" isExecutable="true">
        <startEvent id="sid-3cb4e010-243b-401b-9ad3-4a1f8ecf35d7"/>
        <userTask id="sid-c60eebb9-3a5b-48f9-963c-d0b064344fad" name="请假" flowable:assignee="#{leaveTask}">
            <documentation>员工请假</documentation>
        </userTask>
        <sequenceFlow id="sid-ff0c2afe-1c1c-4e2f-b2eb-5083c5fadb41" sourceRef="sid-3cb4e010-243b-401b-9ad3-4a1f8ecf35d7" targetRef="sid-c60eebb9-3a5b-48f9-963c-d0b064344fad"/>
        <userTask id="sid-dafc35fa-fa0f-49af-9f46-7074fa5a60ab" name="组长审批" flowable:assignee="#{teamTask}"/>
        <sequenceFlow id="sid-32a2a643-9ce6-44f3-bb94-f9df3d97c49b" sourceRef="sid-c60eebb9-3a5b-48f9-963c-d0b064344fad" targetRef="sid-dafc35fa-fa0f-49af-9f46-7074fa5a60ab"/>
        <exclusiveGateway id="sid-c03f8946-a6cd-4e38-881a-70d450e32748" name="组长审批网关"/>
        <sequenceFlow id="sid-bbed6467-cc35-41d2-ad08-2c3b17b8ca83" sourceRef="sid-dafc35fa-fa0f-49af-9f46-7074fa5a60ab" targetRef="sid-c03f8946-a6cd-4e38-881a-70d450e32748"/>
        <sequenceFlow id="sid-afe09a37-7634-4166-8617-68d5f35edef7" sourceRef="sid-c03f8946-a6cd-4e38-881a-70d450e32748" targetRef="sid-c9544983-0465-43e0-b6fc-1dbd0f1e0687" name="组长审批通过">
            <conditionExpression xsi:type="tFormalExpression">${var:equals(checkResult,"通过")}</conditionExpression>
        </sequenceFlow>
        <sequenceFlow id="sid-df2ad71d-6aa1-4d43-a9f9-bbdad8687e3a" sourceRef="sid-c03f8946-a6cd-4e38-881a-70d450e32748" targetRef="sid-e720a425-9f57-4a42-9833-b5f4f0175840" name="组长审批拒绝">
            <conditionExpression xsi:type="tFormalExpression">${var:equals(checkResult,"拒绝")}</conditionExpression>
        </sequenceFlow>
        <userTask id="sid-c9544983-0465-43e0-b6fc-1dbd0f1e0687" name="经理审批" flowable:assignee="#{manageTask}"/>
        <exclusiveGateway id="sid-970d87f2-84d0-4603-ae25-163a0ae7ca53" name="经理审批网关"/>
        <sequenceFlow id="sid-ffa6dd8b-ae8d-47a5-a2ff-45d25e58dcac" sourceRef="sid-c9544983-0465-43e0-b6fc-1dbd0f1e0687" targetRef="sid-970d87f2-84d0-4603-ae25-163a0ae7ca53"/>
        <serviceTask id="sid-e720a425-9f57-4a42-9833-b5f4f0175840" flowable:exclusive="true" name="发送失败提示" isForCompensation="true" flowable:class="com.xx.process.service.LeaveFailService"/>
        <endEvent id="sid-f158c31d-d760-4a06-bb4a-6ff8b156d2fb"/>
        <sequenceFlow id="sid-6e2fc1e3-43be-4768-96f5-d9c7861cbce7" sourceRef="sid-e720a425-9f57-4a42-9833-b5f4f0175840" targetRef="sid-f158c31d-d760-4a06-bb4a-6ff8b156d2fb"/>
        <sequenceFlow id="sid-c90c5e3e-e5c2-40f0-8324-44d548de0ef2" sourceRef="sid-970d87f2-84d0-4603-ae25-163a0ae7ca53" targetRef="sid-e720a425-9f57-4a42-9833-b5f4f0175840" name="经理审批拒绝">
            <conditionExpression xsi:type="tFormalExpression">${var:equals(checkResult,"拒绝")}</conditionExpression>
        </sequenceFlow>
        <endEvent id="sid-ea363fd0-f4ad-4537-9faf-a9349aac16f1"/>
        <sequenceFlow id="sid-5cad8e7b-8ee3-4e34-b94f-920a362f578d" sourceRef="sid-970d87f2-84d0-4603-ae25-163a0ae7ca53" targetRef="sid-ea363fd0-f4ad-4537-9faf-a9349aac16f1" name="经理审批通过">
            <conditionExpression xsi:type="tFormalExpression">${var:equals(checkResult,"通过")}</conditionExpression>
        </sequenceFlow>
    </process>
    <bpmndi:BPMNDiagram id="BPMNDiagram_ask_for_leave">
        <bpmndi:BPMNPlane bpmnElement="ask_for_leave" id="BPMNPlane_ask_for_leave">
            <bpmndi:BPMNShape id="shape-013aa23c-13e6-466e-942b-6a1a308eeda7" bpmnElement="sid-3cb4e010-243b-401b-9ad3-4a1f8ecf35d7">
                <omgdc:Bounds x="-2235.0" y="-1200.0" width="30.0" height="30.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape id="shape-10dbd0c8-a3b1-4a9e-b214-5c506e80fd1d" bpmnElement="sid-c60eebb9-3a5b-48f9-963c-d0b064344fad">
                <omgdc:Bounds x="-2145.0" y="-1224.9999" width="100.0" height="80.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-97bf72f7-edcb-4813-9e03-73bc597d1492" bpmnElement="sid-ff0c2afe-1c1c-4e2f-b2eb-5083c5fadb41">
                <omgdi:waypoint x="-2205.0" y="-1185.0"/>
                <omgdi:waypoint x="-2145.0" y="-1184.9999"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-df2f6c22-1d44-4180-94fb-87753f871822" bpmnElement="sid-dafc35fa-fa0f-49af-9f46-7074fa5a60ab">
                <omgdc:Bounds x="-1945.0" y="-1225.0001" width="100.0" height="80.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-e0d1746e-e6b5-481a-a492-83881d2a9c22" bpmnElement="sid-32a2a643-9ce6-44f3-bb94-f9df3d97c49b">
                <omgdi:waypoint x="-2045.0" y="-1184.9999"/>
                <omgdi:waypoint x="-1945.0" y="-1185.0001"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-6e0e9d80-5884-4ca5-847d-d3e555005c51" bpmnElement="sid-c03f8946-a6cd-4e38-881a-70d450e32748">
                <omgdc:Bounds x="-1735.0" y="-1205.0" width="40.0" height="40.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-9dbfbe2b-c839-44eb-b74b-fceee48631b7" bpmnElement="sid-bbed6467-cc35-41d2-ad08-2c3b17b8ca83">
                <omgdi:waypoint x="-1845.0" y="-1185.0001"/>
                <omgdi:waypoint x="-1735.0" y="-1185.0"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-1ff96c95-d96d-4241-9d0f-85414bbb3859" bpmnElement="sid-c9544983-0465-43e0-b6fc-1dbd0f1e0687">
                <omgdc:Bounds x="-1570.0" y="-1224.9999" width="100.0" height="80.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-f8f6488f-354a-490c-9d22-1f57e9a654d4" bpmnElement="sid-afe09a37-7634-4166-8617-68d5f35edef7">
                <omgdi:waypoint x="-1695.0" y="-1185.0"/>
                <omgdi:waypoint x="-1632.5" y="-1185.0"/>
                <omgdi:waypoint x="-1570.0" y="-1184.9999"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-bb52e23c-ee53-4073-9b74-c5dca8459100" bpmnElement="sid-970d87f2-84d0-4603-ae25-163a0ae7ca53">
                <omgdc:Bounds x="-1395.0" y="-1205.0" width="40.0" height="40.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-6e5e32bc-5b44-41f5-97e6-458c1aa7b7f3" bpmnElement="sid-ffa6dd8b-ae8d-47a5-a2ff-45d25e58dcac">
                <omgdi:waypoint x="-1470.0" y="-1184.9999"/>
                <omgdi:waypoint x="-1395.0" y="-1185.0"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-26269b4b-a620-4e2f-a463-145fdfd8c0b1" bpmnElement="sid-e720a425-9f57-4a42-9833-b5f4f0175840">
                <omgdc:Bounds x="-1764.9999" y="-1055.0" width="100.0" height="80.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape id="shape-47431d28-2f8b-4b2c-81e0-19dc832d1880" bpmnElement="sid-f158c31d-d760-4a06-bb4a-6ff8b156d2fb">
                <omgdc:Bounds x="-1910.0" y="-1030.0" width="30.0" height="30.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-cfc9460b-eaf6-44ee-9baa-300e89b18f4d" bpmnElement="sid-6e2fc1e3-43be-4768-96f5-d9c7861cbce7">
                <omgdi:waypoint x="-1764.9999" y="-1015.0"/>
                <omgdi:waypoint x="-1880.0" y="-1015.0"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNEdge id="edge-46d26639-0c9b-40da-b5ec-10678783920b" bpmnElement="sid-c90c5e3e-e5c2-40f0-8324-44d548de0ef2">
                <omgdi:waypoint x="-1375.0" y="-1165.0"/>
                <omgdi:waypoint x="-1375.0" y="-1015.0"/>
                <omgdi:waypoint x="-1664.9998" y="-1015.0"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="shape-cfc8c0f0-f529-4023-83a6-e8635533be1b" bpmnElement="sid-ea363fd0-f4ad-4537-9faf-a9349aac16f1">
                <omgdc:Bounds x="-1200.0" y="-1200.0" width="30.0" height="30.0"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge id="edge-5c22485e-bc92-4af7-b814-6f384c98ba5d" bpmnElement="sid-5cad8e7b-8ee3-4e34-b94f-920a362f578d">
                <omgdi:waypoint x="-1355.0" y="-1185.0"/>
                <omgdi:waypoint x="-1200.0" y="-1185.0"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNEdge id="edge-eb5ecc69-91e8-4e50-81e2-14123d77ee2d" bpmnElement="sid-df2ad71d-6aa1-4d43-a9f9-bbdad8687e3a">
                <omgdi:waypoint x="-1715.0" y="-1165.0"/>
                <omgdi:waypoint x="-1714.9999" y="-1055.0"/>
            </bpmndi:BPMNEdge>
        </bpmndi:BPMNPlane>
    </bpmndi:BPMNDiagram>
</definitions>

这样项目启动之后，Flowable会自动加载这个流程定义文件，写入数据库相关表。

3.3 流程模型使用

基于模型发起一次审批流程：

arduino 复制代码 
  @Autowired
  RuntimeService runtimeService;
​
  @Autowired
  TaskService taskService;
​
  // 员工id
  public static final String userId = "user_001";
  // 组长id
  public static final String teamId = "team_001";
  // 部门经理id
  public static final String depId = "dep_001";
​
  @Test
  public void leaveRequest() {
      HashMap<String, Object> map = new HashMap<>();
      map.put("leaveTask", userId);
      // 开启流程的key，就是流程定义文件里 process 标签的id
      ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("leave-process", map);
      // 设置一些参数
      runtimeService.setVariable(processInstance.getId(), "name", "java-boy");
      runtimeService.setVariable(processInstance.getId(), "reason", "想休息个几天，心累了");
      runtimeService.setVariable(processInstance.getId(), "days", 3);
      log.info("======>>>创建请假流程, 流程实例processInstanceId：{}", processInstance.getId());
​
  }

上面的实现逻辑其实就是员工user001发起了一次请假申请，并附带了一些变量信息，比如说请假几天之类的。

提交请假：

arduino 复制代码 
   /**
   * 员工提交请假
   */
  @Test
  public void submitToTeam() {
      // 员工查找到自己的任务，然后提交给组长审批
      List<Task> list = taskService.createTaskQuery().taskAssignee(userId).orderByTaskId().desc().list();
      for (Task task: list) {
          Map<String, Object> map = new HashMap<>();
          // 提交给组长的时候，需要指定组长的 id
          map.put("teamTask", teamId);
          taskService.complete(task.getId(), map);
      }
​
  }

审批：

arduino 复制代码 
    /**
     * 组长批准请假
     */
    @Test
    public void teamApprove() {
        List<Task> list = taskService.createTaskQuery().taskAssignee(teamId).orderByTaskId().desc().list();
        for (Task task: list) {
                Map<String, Object> map = new HashMap<>();
                //提交给组长的时候，需要指定组长的 id
                map.put("manageTask", depId);
                map.put("checkResult", "通过");
                map.put("teamTask", teamId);
​
                try {
                    taskService.complete(task.getId(), map);
                } catch (Exception e) {
                    log.error("组长审批失败{} {}", task.getId(), task.getAssignee(), e);
                }
​
            }
        }
​
    }

4.总结

Flowable在功能丰富性和易用性之间取得了良好平衡，虽然表结构看似复杂，但通过合理配置可以大幅简化。对于需要完整BPM功能又希望保持轻量集成的Java项目，它仍然是目前最好的选择之一，非常适合Spring技术栈的项目快速整合工作流。新项目建议从6.7.x版本开始，并合理规划历史数据归档策略。

相关推荐
l5657583 小时前
第五十天(SpringBoot栈&Actuator&Swagger&HeapDump&提取自动化)
java·spring boot·spring
凯哥19703 小时前
vLLM快速入门及安装指南
后端
用户8356290780513 小时前
使用C#轻松提取PDF图片：Spire.PDF for .NET实战教程
后端·c#
凯哥19703 小时前
UV 工具安装与国内镜像源配置指南
后端
用户697244900263 小时前
scala安装和基本使用
后端
荣淘淘4 小时前
互联网大厂Java面试三大回合全解析：从语言特性到性能安全
java·安全·面试·性能优化·互联网·多线程·语言特性
给力学长4 小时前
洗衣店小程序的设计与实现
java·数据库·vue.js·小程序·node.js
该用户已不存在4 小时前
Windows 开发环境这么难配，为什么还有那么多人在用？
前端·windows·后端
二闹4 小时前
告别卡顿！用Python生成器轻松处理海量数据的秘籍
后端·python
热门推荐
01UV安装并设置国内源02奈飞工厂官网，国内Netflix影视在线看|中文网页电脑版入口03Xget：下一代开源资源获取加速引擎，让你的文件下载、储存库克隆和镜像拉取快如闪电04不再让Windows更新！&Edge游戏助手卸载及关闭自动更新05Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code06KGG转MP3工具|非KGM文件|解密音频07Linux下V2Ray安装配置指南08jdk21下载、安装（Windows、Linux、macOS）09A股预测还能更准？开源大模型Kronos带你跑通预测+回测全流程10使用国内镜像网站在线下载安装Qt（解决官网慢的问题）——Qt