[Question]: SeekDB 1.4 removed support for `utf8mb4_unicode_ci`

该报错通常出现在 RAGFlow 使用 DOC_ENGINE=seekdb 并创建数据集时,SeekDB 引擎在创建租户 chunk 表阶段执行建表 DDL 失败。优先排查 SeekDB 版本是否为 1.4.0,以及其是否已恢复对 utf8mb4_unicode_ci 的支持。

快速结论:该报错通常出现在 RAGFlow 使用 DOC_ENGINE=seekdb 并创建数据集时,SeekDB 引擎在创建租户 chunk 表阶段执行建表 DDL 失败。优先排查 SeekDB 版本是否为 1.4.0,以及其是否已恢复对 utf8mb4_unicode_ci 的支持。

适用环境:RAGFlow 搭配 SeekDB 作为文档引擎(DOC_ENGINE=seekdb);已确认触发版本为 SeekDB 1.4.0。Issue 未提供操作系统、Python、CUDA、显卡或依赖版本信息,这里不补写。

最快修复方案:暂无确认的一步修复方案。Issue 中明确说明这是 SeekDB 1.4.0 的上游回归,已在 SeekDB main 分支修复并计划发布新版本;可优先尝试升级到包含该修复的 SeekDB 新版本后再创建数据集。

注意事项:该问题不在 RAGFlow 侧修复,Issue 讨论中明确“No ragflow-side action”。SeekDB 新版本发布信息以官方为准;若升级后仍出现同样报错,应回到 Issue 补充版本与日志。

问题场景

用户在 RAGFlow 中配置 DOC_ENGINE=seekdb,随后创建数据集。SeekDB 引擎尝试创建租户 chunk 表时,建表 DDL 因排序规则不受支持而失败,导致数据集创建无法完成。

报错原文

DDL ob_create_table_ragflow_: Error 1273 (HY000):
Unknown collation: 'utf8mb4_unicode_ci'

原因分析

已确认原因是 SeekDB 1.4.0 意外移除了对 utf8mb4_unicode_ci 的支持。RAGFlow 在建表 DDL 中使用了该排序规则,因此 SeekDB 返回 Error 1273 (HY000): Unknown collation。维护者在 Issue 中表示该问题已在 SeekDB main 分支修复,并会尽快发布新版本;这不是 RAGFlow 侧需要单独修改的问题。

环境排查

  • 确认当前 SeekDB 版本是否为 1.4.0,或是否属于受该回归影响的版本区间。
  • 确认 RAGFlow 的环境变量 DOC_ENGINE 是否设置为 seekdb。
  • 确认创建数据集时触发的报错是否同样发生在租户 chunk 表建表阶段。
  • 确认是否存在可用于升级的 SeekDB 新版本;Issue 未给出具体版本号。
  • Issue 未提供 Python、CUDA、PyTorch、显卡等环境信息,无需据此排查。

解决步骤

  1. 记录当前 SeekDB 版本,确认其是否为 1.4.0 或仍包含 utf8mb4_unicode_ci 支持缺失的版本。
  2. 关注 SeekDB 官方发布,获取已修复 utf8mb4_unicode_ci 支持的新版本;Issue 未提供具体版本号,不要自行假设。
  3. 按 SeekDB 官方升级方式升级到包含修复的版本(可优先尝试)。
  4. 升级完成后重启 RAGFlow 相关服务,使 DOC_ENGINE=seekdb 重新连接 SeekDB。
  5. 重新执行创建数据集操作,观察建表 DDL 是否仍返回 Unknown collation。
  6. 如果使用新 SeekDB 版本后仍失败,回到原 Issue 补充 SeekDB 版本、完整报错与复现步骤。

验证方法

在升级到含修复的 SeekDB 版本后,重新在 RAGFlow 中创建数据集。若不再出现 Error 1273 (HY000): Unknown collation: 'utf8mb4_unicode_ci',且租户 chunk 表能正常创建、数据集创建流程完成,即可认为问题已解决。Issue 中原有的验证记录仍可作为参考,但最终以新版本实测结果为准。

参考来源

infiniflow/ragflow #21181

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 31528

发表回复

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