[Question]: Docs Generator download returns code 102 “Document not found” for DOCX, PDF and HTML

问题场景

用户在 RAGFlow 的 Agent 工作流中搭建如下链路：Begin → Retrieval → Agent → Docs Generator → Message，其中 Message 节点使用 Docs Generator 的下载输出。工作流运行后，Agent 聊天窗口会显示一个下载卡片，但点击下载 DOCX、PDF 或 HTML 文件时无法得到正常文档，浏览器下载或打开的文件内容变成错误 JSON。报告者使用固定静态内容（# Test Report 与一行测试文本）也能复现，说明问题与 Agent 提示词、Markdown 内容、数据集或文件名无关。

报错原文

{"code":102,"message":"Document not found!"}

原因分析

从讨论链看，最可能的原因是 RAGFlow 旧版本中 Doc Generator 生成文件的持久化/存储，或下载接口读取生成文件时存在缺陷：前端已经拿到并展示下载卡片，但后端在下载环节找不到对应文档，于是返回 code 102。维护者提到该问题“可能由 PR #16577 修复”，并表示最新代码应包含在 v0.26.3 中，因此版本过旧是最值得优先排查的方向。另一个可能原因是 Doc Generator 与 Retrieval 节点配置不匹配，或下载卡片所指向的文件并未真正写入可被下载接口访问的存储位置；不过 Issue 中没有给出这两类配置的具体验证结果，不能据此下确定结论。

环境排查

• 确认当前 RAGFlow 版本：是否低于或未包含 v0.26.3，是否缺少 PR #16577 的修复。
• 确认使用的是 RAGFlow Cloud Agent Workflow 还是自建部署，以及是否已更新到维护者回复中的 latest build。
• 检查 Agent 工作流节点顺序是否为 Begin → Retrieval → Agent → Docs Generator → Message，Message 节点是否正确引用 Docs Generator 的下载输出。
• 检查 Doc Generator 的输出格式设置（DOCX、PDF、HTML）是否与实际下载行为一致。
• 按维护者要求补充 Retrieval 与 Doc Generator 的配置截图，确认是否存在节点配置导致生成文件未落盘或未被正确索引。
• Issue 未提供 Python、CUDA、PyTorch、显卡或依赖版本，这些项目无需在本次排错中作为已知条件处理。

解决步骤

1. 先记录当前 RAGFlow 版本，确认它是否早于 v0.26.3 或不包含 PR #16577 的修复。
2. 升级到包含 PR #16577 的最新构建版本；若使用 RAGFlow Cloud，确认云端工作流已运行在更新后的版本上。
3. 重新创建或重新运行同一个 Agent 工作流：Begin → Retrieval → Agent → Docs Generator → Message，Doc Generator 输出格式先选 DOCX，内容使用固定静态测试文本。
4. 运行完成后点击生成的下载按钮，分别测试 DOCX、PDF、HTML 三种输出，观察是否仍返回 {"code":102,"message":"Document not found!"}。
5. 如果升级后仍失败，按维护者在评论中的要求补充 Retrieval 和 Doc Generator 的设置截图，以及下载卡片和报错内容的截图，再开新 Issue 继续排查生成文件的持久化/存储与下载接口。

验证方法

在升级后的版本中重新运行工作流，点击下载卡片后应能得到可正常打开的 DOCX、PDF 或 HTML 文件；文件内容应为固定静态测试文本，而不是 {"code":102,"message":"Document not found!"}。三种输出格式都通过后，可认为该问题已解决。若只有部分格式通过或仍然报错，则说明当前环境可能未包含修复，或还存在生成文件存储与下载接口层面的未验证问题。

参考来源

infiniflow/ragflow #16506

AI 工具推荐

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

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

了解 GamsGo AI

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