[Bug]: Error in previewing DOCX files in knowledge base search results.

用户在 RAGFlow 0.13.0 版本(Commit ID: BUG24110701,Windows 11 Docker 4.34.2 环境)中创建知识库并导入 DOCX 文件后,执行知识库搜索并点击搜索结果中的文件名进行预览时,弹窗显示预览失败;而 PDF 文件预览可正常显示。

[Bug]: Error in previewing DOCX files in knowledge base search results.

[Bug]: Error in previewing DOCX files in knowledge base search results.

快速结论:该报错通常发生在 RAGFlow 知识库搜索结果预览 DOCX 文件时,提示预览失败,而 PDF 文件可正常预览。优先排查 RAGFlow 版本是否低于 0.13.0,并升级到最新代码以启用 DOCX 预览支持。

问题场景

用户在 RAGFlow 0.13.0 版本(Commit ID: BUG24110701,Windows 11 Docker 4.34.2 环境)中创建知识库并导入 DOCX 文件后,执行知识库搜索并点击搜索结果中的文件名进行预览时,弹窗显示预览失败;而 PDF 文件预览可正常显示。

报错原文

Previewing docx in web page has not been supported yet.

原因分析

可能原因是 RAGFlow 该版本(0.13.0)尚未实现对 DOCX 文件在网页中的预览功能,仅支持 PDF 预览。该问题在后续版本中通过代码升级已得到支持。

环境排查

  • 确认 RAGFlow 版本(如 0.13.0)及 Commit ID(如 BUG24110701)是否与 Issue 中一致。
  • 确认 Docker 环境版本(如 Windows11 Docker 4.34.2)。
  • 检查知识库中导入的 DOCX 文件是否格式标准(非加密或损坏文件)。

解决步骤

  1. 可优先尝试升级 RAGFlow 代码到最新版本(如 0.13.0 之后的分支),以获取 DOCX 预览支持。
  2. 如果无法升级,可考虑将 DOCX 文件转换为 PDF 后重新导入知识库作为临时解决方案。
  3. 升级后重启服务,确保新代码生效。

验证方法

升级后,重新创建或使用原有知识库,搜索已导入的 DOCX 文件,点击文件名查看预览窗口是否正常显示内容。若仍失败,请检查 Docker 日志或浏览器控制台是否有额外错误信息。

参考来源

infiniflow/ragflow #3264

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

celebrityanime
celebrityanime
文章: 7448

发表回复

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