Flowable引擎MySQL中文乱码问题解决方案深度解析

背景分析

在使用Flowable工作流引擎6.8.1版本时，开发者发现当MySQL数据库字符集配置为utf8mb4时，引擎自动创建的表却使用了utf8字符集和utf8_bin排序规则，这导致了中文字符存储出现乱码问题。通过源码分析可以追溯到引擎内部提供的SQL脚本文件存在不同数据库版本的差异化配置。

技术原理

MySQL数据库的字符集配置直接影响多语言支持能力：

• utf8字符集：最大支持3字节编码，无法完整支持emoji和部分生僻汉字
• utf8mb4字符集：完整的4字节UTF-8编码，全面支持Unicode字符
• 排序规则：utf8_bin是二进制排序，区分大小写；utf8mb4_general_ci是不区分大小写的通用排序

问题根源

Flowable引擎在6.8.1版本中：

1. 内置的MySQL建表脚本默认指定了utf8字符集
2. 资源目录中同时存在mysql和mssql两种数据库脚本（注意区分文件后缀）
3. 自动建表时未考虑用户数据库的全局字符集配置

解决方案

方案一：手动执行预处理脚本

1. 从Flowable发行版中获取对应版本的SQL脚本
2. 批量替换所有CHARACTER SET utf8为CHARACTER SET utf8mb4
3. 替换COLLATE utf8_bin为COLLATE utf8mb4_general_ci
4. 在应用启动前手动执行修改后的SQL脚本

方案二：自定义Schema管理

@Bean
public SpringProcessEngineConfiguration processEngineConfiguration() {
    SpringProcessEngineConfiguration config = new SpringProcessEngineConfiguration();
    config.setDatabaseSchemaUpdate("false"); // 禁用自动更新
    // 其他配置...
    return config;
}

配合手动执行修改后的建表脚本

方案三：升级引擎版本

新版本Flowable已逐步改进对utf8mb4的支持，建议评估升级到7.x版本的可能性。

最佳实践建议

1. 生产环境推荐使用手动建表方式
2. 统一数据库字符集配置：

   ALTER DATABASE flowable CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   

3. 对于已有数据的迁移：

   ALTER TABLE ACT_RU_TASK CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   

技术思考

该问题反映了数据库兼容性设计的复杂性，建议开发者在技术选型时：

1. 提前规划多语言支持需求
2. 测试环境与生产环境保持字符集一致
3. 对于工作流这类核心系统，建议在项目初期就确定字符集方案

通过合理配置，Flowable引擎完全可以支持完善的中文及其他多语言业务处理需求。