当前位置：首页 > news >正文

SpringBoot 2.6.2 + Flowable 6.7.2 整合避坑指南：从MySQL驱动版本到流程图中文乱码

news 2026/5/1 1:59:35

SpringBoot 2.6.2与Flowable 6.7.2深度整合实战：从环境配置到流程设计全解析

在企业级应用开发中，工作流引擎的选择与整合往往决定了业务流程的灵活性与开发效率。本文将带您深入探索SpringBoot 2.6.2与Flowable 6.7.2的整合过程，不仅解决常见的技术难题，更提供一套可复用的最佳实践方案。

1. 环境准备与基础配置

1.1 版本选择与依赖管理

SpringBoot与Flowable的版本兼容性至关重要。经过多次验证，我们确定以下组合最为稳定：

<properties> <flowable.version>6.7.2</flowable.version> <spring-boot.version>2.6.2</spring-boot.version> </properties>

核心依赖配置如下：

<dependency> <groupId>org.flowable</groupId> <artifactId>flowable-spring-boot-starter</artifactId> <version>${flowable.version}</version> </dependency>

注意：避免同时引入flowable-spring-boot-starter和单独的flowable模块，这可能导致自动配置冲突。

1.2 数据库配置要点

MySQL 8.0驱动与Flowable的整合需要特别注意字符集设置：

spring: datasource: url: jdbc:mysql://localhost:3306/flowable_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver

常见问题解决方案：

建表失败：临时降级到MySQL 5.1.45驱动完成初始化后，可切换回8.0驱动
连接超时：增加&connectTimeout=3000&socketTimeout=30000参数
时区问题：务必设置serverTimezone参数

2. 核心配置与流程部署

2.1 基础配置参数

application.yml中的关键配置：

flowable: async-executor-activate: false # 开发环境关闭异步执行器 database-schema-update: true # 自动更新数据库结构 process-definition-location-prefix: classpath:/processes/ check-process-definitions: true

2.2 流程定义与部署

推荐的项目结构：

src/main/resources ├── processes │ ├── expense-process.bpmn20.xml │ └── approval-process.bpmn20.xml └── diagrams # 流程图图片资源

示例流程定义(部分)：

<process id="expenseProcess" name="费用报销流程" isExecutable="true"> <startEvent id="startEvent" /> <userTask id="fillExpense" name="填写报销单" flowable:assignee="${applicant}" /> <sequenceFlow id="flow1" sourceRef="startEvent" targetRef="fillExpense" /> </process>

部署验证方法：

启动应用检查ACT_RE_PROCDEF表
访问/actuator/flowable端点(需开启Actuator)
使用RepositoryService API查询部署列表

3. 流程可视化与UI整合

3.1 Flowable Modeler整合步骤

静态资源准备：
- 从Flowable GitHub仓库下载前端资源
- 放置到resources/static/modeler目录
依赖添加：

<dependency> <groupId>org.flowable</groupId> <artifactId>flowable-ui-modeler-rest</artifactId> <version>${flowable.version}</version> </dependency>

安全配置调整：

@Configuration @Order(SecurityProperties.BASIC_AUTH_ORDER - 1) public class ModelerSecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .authorizeRequests() .antMatchers("/modeler/**").permitAll(); } }

3.2 中文乱码解决方案

创建配置类解决流程图生成乱码：

@Configuration public class FlowableConfig implements EngineConfigurationConfigurer<SpringProcessEngineConfiguration> { @Override public void configure(SpringProcessEngineConfiguration config) { config.setActivityFontName("SimSun"); config.setLabelFontName("SimSun"); config.setAnnotationFontName("SimSun"); } }

字体配置对照表：

属性	推荐值	说明
activityFontName	宋体/SimSun	活动元素字体
labelFontName	宋体/SimSun	标签字体
annotationFontName	宋体/SimSun	注释字体

4. 通用审批流程设计实践

4.1 可复用流程设计

通用审批流程应包含以下核心节点：

开始节点：初始化流程变量
审批任务：动态指定处理人
修改环节：驳回时返回申请人
网关控制：根据审批结果路由

关键XML配置示例：

<userTask id="approvalTask" name="审批" flowable:assignee="${approver}"> <extensionElements> <flowable:taskListener event="create" class="com.example.flow.listener.ApprovalTaskListener" /> </extensionElements> </userTask>

4.2 业务集成方案

推荐的数据模型设计：

CREATE TABLE `work_order` ( `id` varchar(36) NOT NULL, `business_type` varchar(50) NOT NULL, `business_key` varchar(100) NOT NULL, `status` varchar(20) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

集成步骤：

创建业务工单
设置流程变量
启动流程实例
绑定业务ID与流程ID

4.3 多数据源处理策略

当同时使用Flowable和MyBatis时，建议采用以下方案：

@Configuration @MapperScan(basePackages = "com.example.mapper", sqlSessionFactoryRef = "businessSqlSessionFactory") public class BusinessDataSourceConfig { @Bean(name = "businessDataSource") @ConfigurationProperties(prefix = "spring.datasource.business") public DataSource businessDataSource() { return DataSourceBuilder.create().build(); } @Bean(name = "businessSqlSessionFactory") public SqlSessionFactory sqlSessionFactory( @Qualifier("businessDataSource") DataSource dataSource) throws Exception { SqlSessionFactoryBean bean = new SqlSessionFactoryBean(); bean.setDataSource(dataSource); return bean.getObject(); } }

5. 实战技巧与性能优化

5.1 常见问题排查指南

问题现象	可能原因	解决方案
流程定义未部署	文件位置错误	检查resources/processes目录
任务分配不生效	变量未设置	调试变量${approver}的值
流程图乱码	字体配置缺失	配置中文字体
事务不回滚	异步执行启用	关闭async-executor-activate

5.2 性能优化建议

数据库层面：
- 为ACT_RU_TASK添加business_key索引
- 定期归档历史数据

应用层面：

// 批量查询优化示例 List<Task> tasks = taskService.createTaskQuery() .taskAssignee(userId) .orderByTaskCreateTime().desc() .listPage(0, 100);

缓存策略：
- 对频繁访问的流程定义启用缓存
- 使用Redis缓存用户任务列表

6. 扩展应用与进阶技巧

6.1 动态表单集成

结合Vue+ElementUI实现动态表单：

设计表单JSON模板
前端渲染引擎解析
后端存储表单数据

{ "fields": [ { "type": "input", "label": "报销金额", "model": "amount", "rules": [{ "required": true, "type": "number" }] } ] }

6.2 消息通知方案

集成消息通知的监听器示例：

public class NotificationTaskListener implements TaskListener { @Override public void notify(DelegateTask task) { String assignee = task.getAssignee(); String message = "您有新的待办任务：" + task.getName(); notificationService.send(assignee, message); } }

通知方式对比：