[Bug]: RAGFlow update knowledge base failed when modifying Page Rank with DOC_ENGINE=infinity

快速结论：当你使用 DOC_ENGINE=infinity 启动 RAGFlow 并尝试修改知识库的 Page Rank 时，会因 Infinity 后端根本未实现该功能而报错“Table doesn’t exist”。优先检查：是否在知识库未插入任何文档/Chunk 时修改 Page Rank。

问题场景

用户使用 DOC_ENGINE=infinity 环境变量启动 RAGFlow 服务，创建知识库后，在未插入任何文档或 Chunk 的情况下，直接修改知识库的 Page Rank 参数并点击“保存”，触发后端报错。

报错原文

2025-08-14 15:38:45,871 ERROR    24 (3022, "Table: ragflow_9c6aa3c878e011f0833cc24ba76abba3_39ebec9278e111f09cebc24ba76abba3 doesn't exist.@src/main/query_context.cpp:239")
Traceback (most recent call last):
  File "/ragflow/api/apps/kb_app.py", line 120, in update
    settings.docStoreConn.update({"kb_id": kb.id}, {PAGERANK_FLD: req["pagerank"]},
  File "/ragflow/rag/utils/infinity_conn.py", line 572, in update
    table_instance = db_instance.get_table(table_name)
  ...
infinity.common.InfinityException: (3022, "Table: ragflow_... doesn't exist.@src/main/query_context.cpp:239")

原因分析

Infinity 后端不原生支持 Page Rank 功能。在 RAGFlow 中，Infinity 的知识库表只有在用户首次插入文档或 Chunk 时才会自动创建，而非在创建知识库或修改属性时创建。因此，在插入任何数据前尝试更新 pagerank 字段，会导致 Infinity 查询的表不存在，从而抛出 InfinityException (3022)。这是一个已知的功能缺失限制（参见 issue #8208）。

另外，Infinity 本身存在稳定性问题，例如在添加大量文件、升级配置后，表可能意外丢失或无法正确创建，从而同样导致该报错。

环境排查

确认 DOC_ENGINE 环境变量是否设置为 infinity。
检查 Infinity 镜像版本：示例中使用 infiniflow/infinity:v0.6.0-dev5。
确认知识库中是否已存在至少一个文档或 Chunk。
检查 RAGFlow 代码提交 ID：示例为 f2806a83。

解决步骤

方案一（可优先尝试）：在修改 Page Rank 前，先向目标知识库插入至少一个文档或 Chunk，使 Infinity 自动创建该知识库对应的表。
方案二（降级处理）：放弃使用 Infinity 作为文档引擎，切换为 Elasticsearch 以获取更稳定的 Page Rank 支持。
方案三（故障恢复）：如果表确实丢失（例如在升级或大量操作后），需手动重启 Infinity 集群，并重新插入文档以重建表。自动恢复该缺失表的功能当前未实现。

验证方法

在完成上述步骤后，重新进入知识库设置页面，修改 Page Rank 为非零值并点击保存。观察页面和 RAGFlow 日志，确认不再出现 InfinityException (3022) 报错，且知识库更新成功。

参考来源

infiniflow/ragflow #9476

AI 工具推荐

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

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

了解 GamsGo AI

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

[Bug]: RAGFlow update knowledge base failed when modifying Page Rank with DOC_ENGINE=infinity