[Feature Request]: Restart Failed Subtasks Instead of Restarting Entire Process

[Feature Request]: Restart Failed Subtasks Instead of Restarting Entire Process

快速结论：该请求源于 RAGFlow 在处理大量文档时，因网络故障导致知识图谱提取等昂贵步骤失败后，无法仅重试失败子任务，只能被迫重启整个流程，造成时间与 API 费用的浪费。优先排查方向为：检查当前版本是否支持任务状态持久化或断点续传功能。

问题场景

用户在使用 RAGFlow 处理数万份文档时，启用了标签、Raptor 摘要、知识图谱提取等所有功能。整个解析过程耗时数周，且已通过 DeepSeek API 花费数千元人民币。然而，由于网络故障，大量文档在最后的“知识图谱提取”步骤失败。用户发现没有机制可以仅重试失败文档，当前实现似乎是重试任务最多 3 次，然后直接丢弃整个进度，迫使重启整个流程。

报错原文

[Feature Request]: Restart Failed Subtasks Instead of Restarting Entire Process

I was frustrated to find no way to retry only the failed documents. The current implementation seems to retry a task up to 3 times, and then discard the progress entirely, forcing me to restart the entire pipeline. This results in a complete waste of prior investment in time and tokens.

原因分析

RAGFlow 在文档处理流水线中，缺乏对子任务（subtask）状态的持久化跟踪与断点续传机制。当某个步骤（如知识图谱提取）因网络故障等临时性问题失败时，系统只提供了有限次数的自动重试（目前为 3 次），重试失败后，将整个文档的处理状态标记为失败，丢弃之前所有已完成步骤的结果。用户无法手动选择失败子任务进行重新启动。

环境排查

• RAGFlow 版本：确认当前使用的版本（Issue 创建于 2025 年前后）。此功能请求尚未确认是否已被实现。
• 文档处理配置：检查是否启用了 tags、Raptor summarization、knowledge graph extraction 等高资源消耗功能。
• API 服务提供方：确认是使用 DeepSeek API 还是其他 LLM 服务商，网络稳定性是常见故障源。
• 相关 Issue：官方引用了三个关联 Issue（#8495、#8575、#8466），建议一并关注，可能包含部分实现细节或临时方案。

解决步骤

1. 确认当前版本能力：检查 RAGFlow 官方更新日志或搜索该功能是否已被实现。如果尚未实现，这可能只是一个需求，而非 Bug。
2. 临时规避方案（可能原因）：
   1. 增量式处理：避免一次性提交数万份文档。将文档分批提交，每批处理完毕后，再进入下一批。这样即使一批失败，损失的控制在较小范围内。
   2. 检查自动重试策略：查看 RAGFlow 配置中是否有调整重试次数或重试间隔的参数（非官方确认，需自查）。
   3. 监控网络与 API 状态：在处理前和后，确保 API 服务稳定。对于大任务，建议在非高峰时段执行，或启用本地网络监控。
   4. 备份中间结果：考虑在文件系统或数据库中备份已完成解析步骤的中间数据，以便失败后能手动拼接。
3. 未来期望（功能请求核心）：
   1. 子任务状态跟踪：实现一个持久化任务/状态日志，记录每个子任务（如标签提取、摘要生成、图谱提取）的状态（success、failed、skipped）。
   2. 断点检查点：在流水线的每个关键步骤后保存检查点，使得重启时可以从失败的检查点继续，而不是从头开始。
   3. 选择性重试 UI/API：提供一个功能，允许用户查看所有失败子任务，并一键重试选中的这些子任务。

验证方法

由于这是一个功能请求（Feature Request），而非 Bug 报告，验证方法将在该功能实现后生效：

• 触发一次文档处理任务，在其中故意模拟网络故障（如断开 API 连接）。确认只有失败子任务报告错误。
• 重新建立网络连接后，通过 UI 或 API 找到失败子任务列表，点击“重试”按钮。
• 验证重试仅重新执行失败部分，而之前成功的子任务结果未被重复处理，总处理时间和费用显著降低。

参考来源

infiniflow/ragflow #8682 – Feature Request: Restart Failed Subtasks Instead of Restarting Entire Process

AI 工具推荐

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

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

了解 GamsGo AI

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