[Question]: the page gets stuck during the process of AGENT

问题场景

用户在 RAGFlow 0.23.1 中运行 Agent 工作流，流程执行到输出阶段时后端崩溃，前端页面卡住无响应。刷新页面也无法恢复，用户只能退出并重启整个进程后再次尝试。截图中显示的是页面卡住的状态提示。

报错原文

[Question]: the page gets stuck during the process of AGENT

原因分析

根据 Issue 讨论，导致 Agent 进程崩溃并造成 UI 卡住的原因可能有多种，需要结合日志判断具体属于哪一类：

• 使用 Mineru API 后端时，阻塞式 HTTP 请求可能冻结整个 Agent 系统，当 Mineru 响应缓慢或无响应时尤其容易触发。
• 输入文本过大或格式异常，在 tokenization 阶段引发 stack overflow，导致后端崩溃，前端持续等待响应。
• 前端 JavaScript 错误，例如 React hooks 中的无限递归，可能使页面无响应或空白。
• 后端处理时间过长（如检索缓慢、工作流复杂或资源瓶颈），导致浏览器断连，出现 socket send 异常并卡住 UI。
• Agent 工作流完成阶段数据库连接失败，后端丢弃响应，前端停留在加载状态。
• v0.22.1 之后修复的一个 bug：Agent 进程中对 async generator 进行同步迭代，旧版本可能存在此问题。

Issue 元数据标注为 bug 与 question，关闭时间为 2026-09-17，但未提供单一根因确认。

环境排查

• 确认 RAGFlow 版本（用户报告为 0.23.1）。
• 检查后端日志中是否有 stack trace、panic、timeout 或数据库连接错误。
• 打开浏览器控制台，检查是否有 JavaScript 报错，尤其是 “too much recursion” 一类的前端递归错误。
• 记录问题发生时的输入文本大小与工作流复杂度。
• 确认当前使用的 Mineru 后端模式（是否为 API 后端），以及相关环境变量 MINERU_EXECUTABLE、MINERU_BACKEND、MINERU_SERVER_URL 的配置情况。
• Issue 未提供操作系统、Python、CUDA、显卡、PyTorch 或节点依赖版本，无法据此确认。

解决步骤

1. 查看 RAGFlow 后端日志，定位是否有 stack overflow、panic、timeout 或数据库连接失败的具体堆栈信息。
2. 打开浏览器开发者工具，查看 Console 面板是否存在 JavaScript 报错；若有 “too much recursion” 等前端错误，说明页面卡住可能由前端递归引起。
3. 如果使用 Mineru API 后端，尝试切换为 vlm-http-client 后端模式，通过设置 MINERU_EXECUTABLE、MINERU_BACKEND 和 MINERU_SERVER_URL 环境变量绕过阻塞调用。
4. 限制输入文本大小，避免超大或格式异常的输入触发 tokenization 阶段的 stack overflow。
5. 升级到最新 nightly 版本，其中包含针对长时间处理导致 socket 异常以及 async generator 同步迭代的修复，同时改进了 Agent UI 的错误可见性。
6. 如果问题持续，尝试使用更小的输入、更换模型或 Provider、切换备用后端，并收集完整日志以便进一步诊断。

验证方法

重新运行 Agent 工作流，观察输出阶段是否能正常完成且页面不再卡住。同时确认后端日志中不再出现 stack trace、panic、timeout 或数据库连接错误，浏览器控制台没有 JavaScript 递归报错。如果升级到最新版本后页面能显示更具体的错误信息而不是卡死，也说明改进生效。

参考来源

infiniflow/ragflow #12551

AI 工具推荐

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

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

了解 GamsGo AI

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