[Question]: Error Code 3013 When Viewing Parsed Document Chunk in Ragflow with Infinity

快速结论：该报错发生在 RAGFlow 使用 Infinity 作为向量数据库时，查看已解析文档的 Chunk 触发检索接口，Infinity 返回“Fail to bind the expression: tag_feas”错误（Error Code 3013）。优先排查 RAGFlow 与 Infinity 的版本兼容性，并确认是否存在旧索引表残留或知识图谱（Knowledge Graph）相关字段缺失。

适用环境：RAGFlow 版本 v0.15.1-99-g8f7ecde9（slim），Infinity 版本 v0.6.0-dev1，Python 3.10（RAGFlow 容器内虚拟环境），通过 Docker 部署 RAGFlow 与 Infinity 服务。

最快修复方案：暂无确认的一步修复方案。Issue 中有人反馈“完全重装 RAGFlow（包括清理容器 Volume）后问题消失”，但随后该用户又确认“问题仍然存在”，因此该方案未被最终验证。

注意事项：Issue 已被关闭，但评论区没有明确的最终修复结论；以下方案均为社区成员的尝试，未经官方确认，请优先在测试环境验证。

问题场景

用户使用 RAGFlow（v0.15.1-99-g8f7ecde9 slim 版本）搭配 Infinity（v0.6.0-dev1）作为检索后端。在成功解析一个 TXT 文档后，进入文档 Chunk 查看页面时触发错误。错误发生在 RAGFlow 后端调用 Infinity 检索接口的过程中，具体位于 rag/utils/infinity_conn.py 的 search 方法，最终由 Infinity 的 Thrift 客户端抛出 InfinityException。

报错原文

File "/ragflow/rag/utils/infinity_conn.py", line 343, in search
    kb_res, extra_result = builder.option({"total_hits_count": True}).to_pl()

File "/ragflow/.venv/lib/python3.10/site-packages/infinity/remote_thrift/table.py", line 426, in to_pl
    return self.query_builder.to_pl()

File "/ragflow/.venv/lib/python3.10/site-packages/infinity/remote_thrift/query_builder.py", line 547, in to_pl
    dataframe, extra_result = self.to_df()

File "/ragflow/.venv/lib/python3.10/site-packages/infinity/remote_thrift/query_builder.py", line 540, in to_df
    data_dict, data_type_dict, extra_result = self.to_result()

File "/ragflow/.venv/lib/python3.10/site-packages/infinity/remote_thrift/query_builder.py", line 536, in to_result
    return self._table._execute_query(query)

File "/ragflow/.venv/lib/python3.10/site-packages/infinity/remote_thrift/table.py", line 513, in _execute_query
    raise InfinityException(res.error_code, res.error_msg)

infinity.common.InfinityException: (3013, 'Fail to bind the expression: tag_feas@src/planner/expression_binder.cpp:100')

原因分析

根据 Issue 评论区的信息，可能原因包括：

1. 版本兼容性问题（最可能）：用户反馈从 v0.15.1 升级到 Nightly 版本后，切换检索后端从 Elasticsearch 改为 Infinity，随即开始出现 3013 错误。提示 RAGFlow 与 Infinity 的接口协议或字段定义存在匹配问题。

2. 索引表状态异常：Infinity 日志中出现了 Table ... doesn't exist 的错误，紧随其后才出现 Fail to bind the expression: tag_feas。说明 RAGFlow 在检索时可能引用了尚未创建或已被删除的索引表。

3. 关键词 tag_feas 绑定失败：Infinity 的表达式绑定器（expression_binder）无法识别 tag_feas 这个字段。可能原因是知识图谱（Knowledge Graph）相关的字段没有正确写入索引，或者索引 schema 与 RAGFlow 发送的查询条件不一致。

4. 数据与索引不一致：用户尝试过重新索引文档和删除后重新上传，但错误依旧，说明简单地重新索引可能无法修复底层 schema 或元数据不一致的问题。

环境排查

确认 RAGFlow 版本：检查 docker image inspect ragflow | grep version 或查看 docker-compose.yml 中指定的镜像标签。
确认 Infinity 版本：检查 Infinity 容器的镜像标签或 docker ps 中的版本信息。
确认当前 RAGFlow 使用的检索后端为 Infinity（而不是 Elasticsearch）。
检查 RAGFlow 与 Infinity 是否均为最新版本（或官方文档标注的兼容版本组合）。
检查 Infinity 容器日志中是否存在 Table ... doesn't exist 或 Fail to bind the expression 等错误。

解决步骤

升级 RAGFlow 到 Nightly 或最新版本：评论区有用户反馈从 v0.15.1 切换到 Nightly 后，切换回 Elasticsearch 可正常工作，但该操作并未最终解决 Infinity 下的问题。可优先尝试升级 RAGFlow 镜像到最新版本，并检查是否仍有 3013 错误。
清理旧索引表并重建：进入 Infinity 容器，检查是否存在残留的旧索引表（表名格式类似 ragflow_<uuid>_<uuid>）。如果存在大量孤立表，可考虑清理，然后在 RAGFlow 中重新创建知识库并上传文档。
彻底重装 RAGFlow（含清理 Volume）：评论区有用户反馈“Completely reinstall ragflow (include prune container volume) and the problem gone”，但随后同一用户又确认“The issue still exist”。此操作风险较高，会丢失所有本地数据，仅作为最后尝试手段，且结果未被稳定复现。
切换回 Elasticsearch 后端：如果业务允许，暂时将 RAGFlow 的检索后端切换回 Elasticsearch，避免阻塞工作流。等待官方发布修复版本后再切回 Infinity。
提交详细日志给官方：如果上述步骤均无效，请保留以下信息反馈给 RAGFlow 官方：完整的 Python 堆栈日志、Infinity 容器 docker logs infinity-1 中相关错误段、RAGFlow 容器 docker logs 中检索请求上下文。

验证方法

在完成上述任意修复步骤后，重新进入 RAGFlow 的文档 Chunk 查看页面，确认不再弹出 3013 错误。同时可在生产环境执行一次真实的检索请求（通过 API 或前端对话测试），确认搜索结果能正常返回。此外，检查 Infinity 容器日志中是否不再出现 Fail to bind the expression: tag_feas 或者 Table doesn't exist 的新错误记录。