Apache DolphinScheduler 数据库排序规则导致前端搜索大小写敏感问题解析

在Apache DolphinScheduler从3.1.8版本升级到3.2.2版本的过程中，部分用户反馈前端搜索功能出现了从大小写不敏感变为大小写敏感的情况。这个问题看似是前端功能的改变，实则与数据库的排序规则(COLLATE)设置密切相关。

问题现象

升级后用户发现：

1. 在任务列表、日志查询等所有带搜索功能的界面，输入关键词时必须严格匹配大小写才能检索到结果
2. 例如搜索"Task"时无法匹配到"task"或"TASK"等不同大小写形式的记录
3. 这给用户在实际使用中带来了诸多不便，特别是当系统中有大量任务时

根本原因

经过排查，该问题源于MySQL数据库的排序规则设置差异：

1. 在3.1.8版本中，数据库默认使用大小写不敏感的排序规则（如utf8_general_ci）
2. 当用户通过mysqldump备份3.1.8数据库并恢复到新环境升级到3.2.2时
3. 某些字段的排序规则被自动设置为utf8mb3_bin（二进制排序规则，区分大小写）

技术原理

MySQL的排序规则决定了字符串比较和排序的行为：

• 以_ci结尾的规则（如utf8_general_ci）表示大小写不敏感(case insensitive)
• 以_bin结尾的规则（如utf8mb3_bin）表示二进制比较，区分大小写

DolphinScheduler的搜索功能依赖于数据库的LIKE查询，排序规则的改变直接影响了查询结果的匹配行为。

解决方案

对于遇到此问题的用户，可以考虑以下解决方案：

1. 修改数据库排序规则：

   • 将相关表和字段的排序规则改为utf8mb4_general_ci或utf8_general_ci
   • 示例SQL：ALTER TABLE table_name MODIFY column_name VARCHAR(255) COLLATE utf8mb4_general_ci;

2. 升级注意事项：

   • 在升级前检查数据库的排序规则设置
   • 确保备份和恢复过程中排序规则保持一致

3. 应用层解决方案：

   • 在极端情况下，可以考虑在应用层实现大小写转换后查询
   • 但这会增加系统开销，不是推荐做法

最佳实践

为避免此类问题，建议：

1. 在部署新环境时明确指定数据库的默认排序规则
2. 升级前进行完整的环境检查
3. 对于关键业务系统，先在测试环境验证升级过程

通过理解数据库排序规则对应用功能的影响，可以更好地规划和执行系统升级，确保业务连续性。