别再手动点点点了！用Camunda Modeler + SpringBoot 5分钟搞定一个审批流程（附完整代码）
5分钟极速搭建企业级审批流：Camunda Modeler与SpringBoot实战指南
每次看到团队还在用if-else硬编码审批逻辑时，我的内心都是崩溃的。上周又有个新来的实习生问我："为什么请假审批要改三天代码？" 今天我就用Camunda这个流程引擎神器，带你们体验什么叫"拖拽式开发"——从画流程图到上线REST API接口，全程只需5分钟咖啡时间。
1. 环境准备：零配置启动Camunda生态
在开始画流程图之前，我们需要三样工具：Modeler设计器、SpringBoot运行环境、以及一个能跑流程的引擎。别被吓到——实际上你只需要：
# 下载Camunda Modeler（选对应系统版本） wget https://camunda.com/download/modeler/安装完成后打开Modeler，你会看到一个清爽的界面。左边是各种流程元素（用户任务、服务调用、网关等），中间是画布区，右边是属性配置面板——这将成为你今后最熟悉的三个区域。
常见安装问题排查表：
| 问题现象 | 解决方案 |
|---|---|
| 启动报Java版本错误 | 安装JDK 11+并配置JAVA_HOME |
| 流程图保存失败 | 检查文件路径是否包含中文/特殊字符 |
| 元素拖拽无反应 | 重启软件或更新显卡驱动 |
提示：Modeler默认保存的是.bpmn格式文件，这是符合BPMN 2.0标准的XML文件，可以用任何文本编辑器查看和修改
2. 绘制第一个审批流程：从请假单开始
让我们用最常见的请假审批场景练手。在Modeler中新建文件，按Ctrl+S保存为leave-request.bpmn。然后依次拖入这些元素：
- 开始事件（圆形）：表示流程起点
- 用户任务（圆角矩形）：命名为"提交请假申请"
- 排他网关（菱形）：用于判断审批路径
- 两个用户任务：分别命名为"部门审批"和"HR备案"
- 结束事件（粗边圆形）：流程终点
用连接线把它们串起来后，你的流程图应该像这样：
开始 → 提交申请 → 网关 →（3天以下）→ 部门审批 → 结束 ↘（3天以上）→ HR备案 → 结束关键配置技巧：
- 双击网关连线设置条件表达式，例如：
${days <= 3} - 在用户任务的"Assignee"属性中设置负责人，可以用固定值如"zhangsan"，或者表达式
${initiator} - 为每个任务添加表单字段：点击任务→Forms→添加
days(数字)、reason(文本)等变量
<!-- 这是自动生成的BPMN代码片段示例 --> <userTask id="task_approve" name="部门审批"> <extensionElements> <camunda:formData> <camunda:formField id="days" label="请假天数" type="long" /> </camunda:formData> </extensionElements> </userTask>3. SpringBoot集成：让流程图跑起来
光有图纸不够，我们需要让流程真正运转。新建一个SpringBoot项目，添加这两个依赖：
implementation 'org.camunda.bpm.springboot:camunda-bpm-spring-boot-starter-webapp:7.18.0' implementation 'org.springframework.boot:spring-boot-starter-jdbc'然后在application.yml中添加：
camunda.bpm: admin-user: id: demo password: demo filter: create: All tasks启动项目后，你会自动获得：
- 流程引擎：http://localhost:8080/engine-rest
- 任务管理台：http://localhost:8080/camunda/app/tasklist
- 监控面板：http://localhost:8080/camunda/app/cockpit
把之前画的leave-request.bpmn文件复制到src/main/resources目录下——SpringBoot会自动部署它！现在访问任务管理台，用demo/demo登录，应该能看到刚部署的请假流程。
4. 编写业务逻辑：ServiceTask实战
审批流的核心是业务处理。我们在部门审批后添加一个ServiceTask节点，用来发送通知邮件：
- 在Modeler中拖入ServiceTask，命名为"发送审批通知"
- 设置实现类型为"Delegate Expression"，值为
${emailSender} - 在Spring项目中创建处理类：
@Component("emailSender") public class SendEmailDelegate implements JavaDelegate { private static final Logger LOG = Logger.getLogger(SendEmailDelegate.class.getName()); @Override public void execute(DelegateExecution execution) { String requester = (String) execution.getVariable("initiator"); Long days = (Long) execution.getVariable("days"); LOG.info("给" + requester + "发送邮件：您的" + days + "天请假已审批通过"); } }变量传递的三种方式：
- 启动时传入：
runtimeService.startProcessInstanceWithVariables() - 任务完成时：
taskService.complete(taskId, variables) - 在Delegate中设置：
execution.setVariable("key", value)
注意：ServiceTask是同步操作，如果需要异步处理，应该使用ExternalTask模式
5. 流程监控与异常处理
上线后难免遇到流程卡住的情况。Camunda自带的Cockpit控制台提供了强大的监控能力：
- 流程实例视图：查看所有运行中的流程，支持按状态筛选
- 活动实例统计：发现瓶颈节点（如某个审批环节平均耗时过长）
- 历史记录：审计完整的流程轨迹
对于异常情况，我常用的处理命令：
// 强制终止卡住的流程 runtimeService.deleteProcessInstance(processInstanceId, "系统超时自动终止"); // 重新分配任务 taskService.setAssignee(taskId, "新的审批人"); // 修复数据不一致 runtimeService.setVariable(executionId, "correctValue", 123);典型故障处理流程：
- 在Cockpit中找到异常流程实例ID
- 检查日志确认最后成功执行的节点
- 通过REST API或Java API进行干预
- 记录操作日志以便审计
6. 进阶技巧：动态路由与多级审批
当基础流程跑通后，可以尝试这些企业级功能：
条件路由增强：
// 在网关条件中使用更复杂的表达式 ${days > 3 && requester.level < 3 && !holidayChecker.isHoliday(startDate)}多实例审批（会签/或签）：
<userTask id="groupApprove" name="部门会签"> <multiInstanceLoopCharacteristics isSequential="false"> <loopCardinality>3</loopCardinality> <!-- 需要3人审批 --> </multiInstanceLoopCharacteristics> </userTask>REST API集成示例：
// 发起新流程 ProcessInstance instance = runtimeService.startProcessInstanceByKey( "leaveRequest", Variables.putValue("days", 5) ); // 查询待办任务 List<Task> tasks = taskService.createTaskQuery() .taskAssignee("zhangsan") .processDefinitionKey("leaveRequest") .list();在实际项目中，我习惯把常用操作封装成工具类。比如这个审批历史查询方法：
public List<Map<String, Object>> getApprovalHistory(String processInstanceId) { return historyService.createHistoricActivityInstanceQuery() .processInstanceId(processInstanceId) .activityType("userTask") .list() .stream() .map(instance -> Map.of( "taskName", instance.getActivityName(), "approver", instance.getAssignee(), "endTime", instance.getEndTime() )) .collect(Collectors.toList()); }记得第一次用Camunda实现财务报销流时，原本两周的开发量压缩到了两天。最让我惊喜的是——当业务方要求增加二级审批时，我只在流程图上拖了个新节点就搞定了，完全不用改代码。这种敏捷性正是现代开发最需要的。