Activiti开发环境怎么配置?Activiti环境搭建详细教程

配置 Activiti 开发环境通常涉及几个核心步骤:选择合适的版本、搭建 Java 开发环境、引入依赖、配置数据库以及编写第一个流程定义,以下是基于 Activiti 7(目前主流且推荐用于 Spring Boot 集成的版本)的详细配置指南。


前置要求

在开始之前,请确保你的开发机器已安装以下软件:

  • JDK 8 或 JDK 11:Activiti 7 支持 JDK 8+。
  • Maven 3.6+:用于管理项目依赖。
  • IDE:IntelliJ IDEA 或 Eclipse(推荐 IntelliJ IDEA)。
  • 数据库:MySQL 5.7/8.0、Oracle、PostgreSQL 或 H2(测试用)。
  • Spring Boot:Activiti 7 与 Spring Boot 2.x/3.x 集成最佳。

创建 Spring Boot 项目

使用 Spring Initializr 创建一个标准的 Spring Boot 项目。

1 添加依赖

在 pom.xml 中添加以下依赖:

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Activiti Spring Boot Starter -->
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-spring-boot-starter</artifactId>
        <version>7.1.0.M6</version> <!-- 请使用最新稳定版 -->
    </dependency>
    <!-- 数据库驱动 (以 MySQL 为例) -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    <!-- 可选:H2 数据库用于快速测试 -->
    <!--
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
    -->
</dependencies>

注意:Activiti 7 与 Spring Boot 2.x 配合使用最稳定,如果使用 Spring Boot 3.x,请确认 Activiti 版本兼容性(可能需要使用 Activiti 8 或等待 Activiti 7 的后续更新)。


配置文件 application.yml

在 src/main/resources/application.yml

Activiti开发环境怎么配置?Activiti环境搭建详细教程

中配置数据库和 Activiti 行为。

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/activiti_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
# Activiti 配置
activiti:
  # 是否启动时自动创建或更新数据库表结构
  database-schema-update: true
  # 是否检查流程定义文件的合法性
  db-history-used: true
  # 历史级别:none, activity, audit, full (推荐 audit 或 full 用于调试)
  history-level: full
  # 检查流程定义版本
  check-process-definitions: false

关键点说明:

  • database-schema-update: true:首次运行时,Activiti 会自动在数据库中创建 25+ 张核心表(如 ACT_RE_, ACT_RU_ 等)。
  • history-level: full:记录所有流程实例、任务、变量的历史数据,便于排查问题。

编写第一个流程定义

在 src/main/resources/processes/ 目录下创建一个 BPMN 文件,leave.bpmn。

leave.bpmn 内容示例:

<?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:activiti="http://activiti.org/bpmn"
             targetNamespace="http://www.example.org/process">
    <process id="leaveProcess" name="请假流程" isExecutable="true">
        <startEvent id="startEvent" name="开始"/>
        <userTask id="managerApproval" name="经理审批" activiti:assignee="manager"/>
        <endEvent id="endEvent" name="结束"/>
        <sequenceFlow id="flow1" sourceRef="startEvent" targetRef="managerApproval"/>
        <sequenceFlow id="flow2" sourceRef="managerApproval" targetRef="endEvent"/>
    </process>
</definitions>

提示:建议使用 Activiti Modeler 或

Activiti开发环境怎么配置?Activiti环境搭建详细教程

Camunda Modeler(两者 BPMN 兼容)来可视化绘制流程图,然后导出为 .bpmn 文件。


创建 REST API 控制器

创建一个简单的 Controller 来启动流程、完成任务。

import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@RestController
@RequestMapping("/api/leave")
public class LeaveController {
    @Autowired
    private RuntimeService runtimeService;
    @Autowired
    private TaskService taskService;
    // 1. 启动流程
    @PostMapping("/start")
    public String startProcess() {
        Map<String, Object> variables = new HashMap<>();
        variables.put("days", 3); // 传递业务变量
        ProcessInstance instance = runtimeService.startProcessInstanceByKey("leaveProcess", variables);
        return "流程启动成功,实例ID: " + instance.getId();
    }
    // 2. 查询待办任务
    @GetMapping("/tasks")
    public List<Task> getTasks(@RequestParam String assignee) {
        return taskService.createTaskQuery()
                .taskAssignee(assignee)
                .list();
    }
    // 3. 完成任务
    @PostMapping("/complete/{taskId}")
    public String completeTask(@PathVariable String taskId) {
        taskService.complete(taskId);
        return "任务完成: " + taskId;
    }
}

启动与验证

  1. 启动 Spring Boot 应用。
  2. 观察控制台日志,确认 Activiti 成功创建了数据库表(如 ACT_RE_DEPLOYMENT, ACT_RU_TASK 等)。
  3. 使用 Postman 或浏览器调用接口:
    • POST http://localhost:8080/api/leave/start → 启动流程。
    • GET http://localhost:8080/api/leave/tasks?assignee=manager → 查看经理待办任务。
    • POST http://localhost:8080/api/leave/complete/{taskId} → 完成任务。

常见问题与调试技巧

Q1: 数据库表未创建?

  • 检查 application.yml

    Activiti开发环境怎么配置?Activiti环境搭建详细教程

    中的 activiti.database-schema-update 是否为 true。

  • 检查数据库连接是否正确,用户是否有创建表的权限。
  • 查看启动日志中是否有 SQL 执行错误。

Q2: 流程定义未部署?

  • 确保 .bpmn 文件放在 src/main/resources/processes/ 目录下(默认扫描路径)。
  • 或者手动部署:
    RepositoryService repositoryService = engine.getRepositoryService();repositoryService.createDeployment()    .addClasspathResource("processes/leave.bpmn")    .deploy();

Q3: 如何查看流程实例状态?

  • 直接查询数据库中的 ACT_RU_EXECUTION 和 ACT_RU_TASK 表。
  • 使用 Activiti Explorer(旧版)或 Camunda Modeler 的插件查看运行时状态。

Q4: Activiti 7 vs Activiti 6 vs Activiti 8

特性Activiti 6Activiti 7Activiti 8
架构单体架构模块化架构微服务架构
集成传统 SpringSpring Boot 友好云原生、Kubernetes
推荐场景遗留系统维护大多数 Spring Boot 项目云原生、微服务架构

建议:新项目优先选择 Activiti 7(与 Spring Boot 集成成熟)或 Camunda 7/8(功能更强大,社区活跃)。


扩展:使用 Activiti Modeler(可选)

如果你需要可视化设计流程,可以集成 Activiti Modeler:

  1. 克隆 Activiti Modeler 仓库。
  2. 将 activiti-modeler 模块集成到你的 Spring Boot 项目中。
  3. 配置资源映射,使其可通过 Web 界面访问。

通过以上步骤,你已经成功配置了一个基本的 Activiti 开发环境,接下来可以深入学习:

  • 监听器(ExecutionListener, TaskListener)
  • 服务任务(JavaDelegate, SpringBeanDelegate)
  • 网关(排他网关、并行网关)
  • 历史数据查询与分析

如有具体问题,欢迎继续提问!

【版权声明】:本站所有内容均来自网络,若无意侵犯到您的权利,请及时与我们联系将尽快删除相关内容!

赞 (0)
热舞的头像热舞
上一篇 2026-07-10 04:39
下一篇 2026-07-10 05:24

相关推荐

  • 小v的ai大模型是什么,它到底怎么用才对?

    小v的ai大模型并非一个简单的聊天工具,而是一套深度结合中文语境、强调本地化部署与可控性的实用型AI解决方案,其核心价值在于把“能用”和“好用”做到了平衡,这句话听起来可能有点绕,但它是理解小v的ai大模型的关键,过去两年,各类大模型层出不穷,但真正落地到具体工作流里,大家普遍会碰到几个坎儿:数据安全不敢上云……

    2026-11-19
    000
  • AI大模型如何看视频,有哪些好用的工具?

    用AI大模型看视频,这件事在2026年已经不只是“能看”这么简单用AI大模型看视频的核心结论是:把视频抽帧、切片或直接喂给具备视觉理解能力的多模态模型,就能在几分钟内拿到摘要、时间轴、关键画面和可检索的文字笔记,成本比人工拉片低一个量级,前提是选对工具链、控制好分辨率和抽帧密度,并且清楚哪些环节必须人工复核,A……

    2026-11-19
    000
  • AI大模型到底能带来哪些价值,企业如何落地应用大模型?

    AI大模型带来的价值,说到底就一句话:它把过去只能靠人一点点做的“阅读、整理、起草、初筛”变成了一道可以批量调用的工序,让人从重复劳动里退出来,去做判断和担责, 它不替你拍板,但能把拍板之前那80%的准备活儿干到接近可交付的水平,ai大模型带来的价值有哪些?拆成四层看更清楚把“价值”笼统地夸一遍没有意义,真正能……

    2026-11-19
    000
  • 小医仙AI大模型靠谱吗?,小医仙ai大模型怎么用

    小医仙AI大模型的核心价值,不是替代医生,而是把预问诊、病历摘要、随访和转诊建议做成可审计的辅助链路;先选高频低风险科室试点,比一上来全院铺开更稳,小医仙AI大模型到底解决什么问题基层医疗的三个真实卡点很多机构第一次接触医疗AI,容易盯着“模型有多大”,真到门诊现场,问题往往很具体:医生时间被切碎,问诊、写病历……

    2026-11-19
    000

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

广告合作

QQ:14239236

在线咨询: QQ交谈

邮件:asy@cxas.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信