SpringBoot + Activiti 7.1.0 工作流实战：从零搭建请假审批系统

原创

于 2026-03-08 10:46:05 发布 · 410 阅读

标签

SpringBoot + Activiti 7.1.0 工作流实战：从零搭建请假审批系统

如果你正在为团队或公司内部那些繁琐、重复的纸质或聊天工具审批流程感到头疼，这篇文章或许能给你一个清晰的解决思路。想象一下，员工提交请假申请后，系统能自动流转到部门主管，主管审批后自动通知HR备案，整个过程无需人工干预，状态实时可查。这背后，正是工作流引擎在发挥作用。对于Java开发者而言，SpringBoot的便捷与Activiti的流程编排能力结合，是实现业务流程自动化的黄金搭档。本文将聚焦于企业OA中最经典的请假审批场景，使用Activiti 7.1.0最新版本，带你从零开始，一步步构建一个包含多级审批、业务数据绑定的完整系统。我们不仅会解决SpringBoot集成时的常见“坑点”，比如如何优雅地绕开默认的Spring Security配置，更会提供一套可直接复用的业务代码模板，让你在理解原理的同时，能快速将这套方案应用到自己的项目中。

1. 环境准备与项目初始化

在动手敲代码之前，我们需要先把舞台搭好。一个清晰、无干扰的初始环境是后续一切顺利的基础。这里我们选择SpringBoot 2.7.x作为基础框架，它提供了极简的配置和快速的启动能力。数据库方面，MySQL 8.0是目前的主流选择，与Activiti的兼容性也最好。请注意，Activiti 7.x版本在依赖和自动配置上与之前的6.x有较大不同，直接引用官方Starter是最佳实践。

1.1 依赖管理与关键配置

创建一个全新的SpringBoot项目，我习惯使用spring-initializr，只选择Spring Web和Lombok作为初始依赖。然后，在pom.xml中手动添加Activiti的核心依赖。这里有一个细节需要注意：Activiti 7.1.0的Starter会自动引入Spring Security，这对于一个纯粹的后台流程引擎服务来说，有时是多余的，甚至会和项目中已有的安全框架冲突。因此，我们需要在引入依赖时就做好排除。

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring-boot-starter</artifactId>
    <version>7.1.0.M6</version>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>

提示：版本号7.1.0.M6是撰写本文时的最新里程碑版本，请根据官方仓库更新至稳定版。排除spring-security-core是关键一步，能有效避免后续的权限验证干扰。

接下来是application.yml的配置。除了常规的数据源配置，我们需要特别关注Activiti的数据库策略。在开发阶段，我强烈建议将database-schema-update设置为true，这样在应用启动时，Activiti会自动检查并创建所需的28张表（如果不存在的话）。这比手动执行SQL脚本要方便得多。

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/activiti_demo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver
  activiti:
    database-schema-update: true # 开发环境设为true，自动建表/更新表结构
    db-history-used: true
    history-level: audit # 历史记录级别，audit会保存所有流程实例信息
    check-process-definitions: false
server:
  port: 8080

1.2 解决Spring Security自动配置问题

即使我们在依赖中排除了Spring Security的核心包，Activiti Starter内部的一些自动配置类可能仍然会尝试配置与身份相关的Bean，这可能导致启动报错。最彻底的解决方式是在主启动类上，显式排除Activiti的身份自动配置。

import org.activiti.core.common.spring.identity.config.ActivitiSpringIdentityAutoConfiguration;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication(exclude = {ActivitiSpringIdentityAutoConfiguration.class})
public class LeaveApprovalApplication {
    pu

最低0.47元/天解锁文章