[Question]: After creating an agent in version 0.21.1, the screen goes blank and nothing is displayed.

问题场景

用户在使用 RAGFlow 0.21.1 的 Agent 编辑功能时，创建 Agent 后页面立即变成空白，界面没有任何内容渲染。该问题不涉及特定节点类型，属于前端 UI 渲染层面的崩溃。

报错原文

[Question]: After creating an agent in version 0.21.1, the screen goes blank and nothing is displayed.

# 浏览器控制台可能出现的错误（需自行确认）
Uncaught RangeError: Maximum call stack size exceeded
# 或
Uncaught RangeError: Too much recursion

原因分析

以下原因均为”可能原因”，按已有讨论的关联度排序：

最可能的原因是前端 React 钩子 useGetBeginNodeDataInputs（位于 use-get-begin-query.tsx）在每次渲染时都返回新的数组引用，导致 React 组件陷入无限循环渲染，最终触发栈溢出，页面白屏。这属于 React 依赖陷阱（dependency trap），必须通过代码修复（例如对返回值做 memo 化）解决。

其他可能性：Agent 图谱中如果存在循环引用（circular references），在最近的重构后也可能引发栈溢出和白屏；或者后端在 Agent 创建后没有返回必要元数据，导致前端渲染失败。

环境排查

• 确认 RAGFlow 版本是否为 0.21.1，或是否有更新补丁可用（可参考 PR #11594 的合入时间）。
• 按 F12 打开浏览器开发者工具，切换到 Console（控制台）标签页，复现白屏并查看是否有 Maximum call stack size exceeded 或 Too much recursion 报错。
• 确认 Agent 图形中是否存在循环连接（A 指向 B、B 又指回 A 的路径）。

解决步骤

1. 先打开浏览器控制台复现白屏，记录具体的红色报错信息和堆栈（stack trace），这是判断根因最直接的证据。
2. 尝试创建一个极简 Agent（只包含 Begin 节点和 End 节点，中间不加任何环节），刷新页面后查看是否仍然白屏——如果简单 Agent 正常，问题可能与图谱结构有关。
3. 检查 Agent 图谱中是否存在循环引用线路，如果存在，删除循环路径后重新保存并刷新。
4. 可优先尝试将 RAGFlow 升级到最新补丁版本或 nightly 版本，因为 PR #11594（合并于 2025-11-28）修复了一个相关的 Agent 嵌入错误，可能包含在后续版本中。
5. 如果上述步骤均无法解决，且控制台确实出现递归或空引用错误，基本可以确认是 useGetBeginNodeDataInputs 钩子的 React 依赖问题，只能等待官方在代码层面修复，当前没有配置层面的变通方案。

验证方法

重新创建 Agent 或加载已有 Agent，确认页面可以正常显示节点画布；再次按 F12 查看控制台，确认没有新的递归或栈溢出报错。如果之前能稳定复现白屏，修复后应无法再复现。

参考来源

infiniflow/ragflow #11734（讨论中引用了 #9926、#10726、#10683、PR #11594 等关联线索）

AI 工具推荐

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

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

了解 GamsGo AI

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