企业官网建设流程全解析

Flowable生产级数据库迁移实战：从H2内存库到MySQL的完整避坑手册

刚接触Flowable的开发者往往会被它开箱即用的H2内存数据库吸引——无需额外配置，解压即运行。但当你准备将工作流系统投入实际业务时，H2的局限性就会显现：服务重启数据丢失、无法多节点共享、缺乏生产级监控工具。这时，数据库迁移就成为必经之路。本文将手把手带你完成从H2到MySQL 5.7/8.0的平滑过渡，重点解决配置过程中90%开发者都会遇到的典型问题。

1. 迁移前的环境诊断与准备

在修改任何配置文件之前，我们需要先理清现有环境的技术栈。通过查看Tomcat的webapps/flowable-ui/WEB-INF/classes目录，你会发现三个关键配置文件：

• flowable-default.properties：主配置入口
• flowable-ui-app.properties：UI模块专属配置
• flowable-rest-app.properties：REST API服务配置

迁移前必做检查清单：

1. 记录当前H2连接的完整JDBC URL（含所有参数）
2. 确认MySQL服务版本（5.7与8.0配置有差异）
3. 检查Tomcat的lib目录是否包含MySQL驱动jar
4. 备份原始配置文件（建议使用Git创建版本快照）

重要提示：生产环境强烈建议为Flowable创建专属数据库用户，避免使用root账户。最小权限原则应授予该用户CREATE/DROP/ALTER等DDL权限。

2. MySQL驱动选择与部署策略

不同MySQL版本需要匹配特定版本的JDBC驱动。以下是经过实测的版本组合：

驱动部署有两种方式：

方案A：Tomcat全局部署（推荐）

# 将驱动放入Tomcat的lib目录 cp mysql-connector-java-8.0.28.jar $CATALINA_HOME/lib/

方案B：应用内嵌部署

<!-- 在Maven项目中添加依赖 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.28</version> </dependency>

3. 核心配置参数详解

打开flowable-default.properties，我们需要重点修改以下参数组：

# 数据源类型切换 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/flowable_db?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8 spring.datasource.username=flowable_user spring.datasource.password=YourStrong@Password123 # 连接池优化（根据服务器配置调整） spring.datasource.hikari.maximum-pool-size=20 spring.datasource.hikari.connection-timeout=30000

高频踩坑点解析：

• 时区问题：MySQL 8.0默认使用UTC时区，必须显式指定serverTimezone
• SSL警告：开发环境可暂时禁用SSL（生产环境需配置证书）
• 编码问题：必须设置characterEncoding=utf8避免中文乱码
• 密码特殊字符：包含@符号的密码需要用单引号包裹

4. 数据库初始化与版本控制

首次启动时，Flowable会自动创建所需的28张表。但你可能需要手动执行初始化脚本：

-- 创建专用数据库 CREATE DATABASE flowable_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 授权给应用账号 GRANT ALL PRIVILEGES ON flowable_db.* TO 'flowable_user'@'%'; FLUSH PRIVILEGES;

版本升级注意事项：

1. 大版本升级（如6.6→7.0）需要手动执行升级脚本
2. 使用ACT_GE_PROPERTY表查看当前数据库版本
3. 升级前务必备份数据，特别是ACT_RU_*运行时表

5. 验证迁移成功的六大关键指标

配置完成后，需要通过多维度验证迁移是否真正成功：

1. 基础验证：登录Flowable UI，检查能否正常创建流程定义
2. 数据持久化验证：重启Tomcat后检查任务是否仍然存在
3. 性能基准测试：使用JMeter模拟并发流程启动
4. 表结构验证：确认所有ACT_*表已正确创建
5. 日志分析：检查catalina.out是否有JDBC连接错误
6. API兼容性测试：确保原有REST接口仍可正常调用

典型问题排查命令：

# 查看MySQL连接状态 SHOW STATUS LIKE 'Threads_connected'; # 检查最大连接数 SHOW VARIABLES LIKE 'max_connections';

6. 生产环境优化建议

当系统正式上线后，这些优化措施能显著提升稳定性：

数据库参数调优：

[mysqld] innodb_buffer_pool_size = 4G innodb_log_file_size = 256M max_connections = 200

Flowable专属配置：

# 启用二级缓存 flowable.process-definition-cache.enabled=true flowable.process-definition-cache.size=1024 # 历史数据归档设置 flowable.history-level=audit flowable.async-executor-activate=true

监控方案推荐组合：

• Prometheus + Grafana监控数据库指标
• Spring Boot Actuator暴露健康检查端点
• 阿里云DMS进行慢SQL分析

7. 迁移后的维护要点

在实际运维中，这几个时间点需要特别注意：

1. 每日检查：连接池使用率、活跃流程实例数
2. 每周维护：OPTIMIZE TABLE优化碎片化严重的表
3. 每月任务：清理ACT_HI_*历史表（设置自动归档策略）
4. 版本升级：先在生产环境测试库验证兼容性

备份策略示例：

# 每天全量备份 mysqldump -uflowable_user -p flowable_db > flowable_$(date +%F).sql # 二进制日志增量备份 mysqlbinlog --start-datetime="2023-08-01 00:00:00" /var/lib/mysql/mysql-bin.000123 > incr_backup.sql

遇到性能瓶颈时，我通常会优先检查ACT_RU_TASK和ACT_RU_EXECUTION表的索引情况。曾经有个客户环境因为缺少ACT_RU_TASK(PROC_INST_ID_)索引导致页面加载慢了15倍，加上索引后立即恢复正常。