FastGPT循环节点使用注意事项与避坑说明

基础使用限制

循环节点存在明确的使用限制与约束，内部无法放入另一个循环节点或并行执行节点。此类嵌套操作会破坏流程的执行逻辑，无法正常完成运行。

结果聚合与变量处理规范

新版循环节点的自定义输出在退出时，仅包含最后一轮迭代的值，不再默认将所有轮次的输出聚合成一个数组。如需将每一轮的数据收集并汇总为列表，需执行以下配置步骤：

1. 在循环体外部声明一个全局变量数组；
2. 在循环体内部使用【变量更新】节点，每次将当前轮次的结果追加到该全局变量中。

每轮成功结束后，循环体内对全局变量的修改会写回主流程；通过变量更新修改循环容器外节点输出时，也会在该轮成功结束后写回。失败轮不会提交本轮变量或外部输出变更；遇到交互节点暂停时，会作为可恢复checkpoint保留暂停前已完成节点的更新，便于后续恢复运行。

死循环防范机制

条件循环必须在子流程的某个分支能最终触发【循环终止】节点，否则可能导致无限运行。系统设定了最大循环次数，默认值为100次，达到上限后会自动报错并安全停止，遵循预设的异常处理规则。

来源： FastGPT 官方来源

来源： FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 教程 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。