在 n8n 中循环
当您想要处理多个项目或重复执行某个操作(例如向地址簿中的每个联系人发送消息)时,循环非常有用。 n8n 自动处理这种重复处理,这意味着您无需在工作流程中专门构建循环。 某些节点 的情况并非如此。
循环是 n8n 流程逻辑的一部分,其他部分还包括拆分和合并数据流,以及在执行之间等待。
在 n8n 中使用循环
n8n 个节点将任意数量的项目作为输入,处理这些项目,并输出结果。您可以将每个项目视为单个数据点,或节点输出表中的单个行。

节点通常为每个项目运行一次。例如,如果您想要将客户数据存储节点中客户的姓名和注释作为 Slack 上的消息发送,您可以:
- 将 Slack 节点连接到客户数据存储节点。
- 配置参数。
- 执行节点。
您将收到五条消息:每条消息对应一个项目。
通过这种方式,您可以处理多个项目,而无需在循环中显式连接节点。
执行节点一次
对于您不希望节点处理所有收到的项目的情况,例如仅向第一个客户发送 Slack 消息,您可以通过切换该节点的 Settings 设置 选项卡中的 Execute Once 执行一次 参数来实现此目的。当传入数据包含多个项目并且您只想处理第一个项目时,此设置非常有用。
创建循环
n8n 通常处理所有传入项目的迭代。但是,在某些情况下,您必须创建循环来迭代所有项目。有关不会自动迭代所有传入项目的节点列表,请参阅节点异常。
循环直到满足条件
要在 n8n 工作流中创建循环,请将一个节点的输出连接到前一个节点的输入。添加 IF 节点以检查何时停止循环。
下面是一个使用 IF 节点实现循环的示例工作流程:

循环直到处理完所有项目
如果您想要循环直到处理完所有项目,请使用 循环项目 节点。要单独处理每个项目,请将 Batch Size 批量大小 设置为 1。
您可以将数据分组为批次并逐批处理。在处理大量传入数据或希望处理特定的一组返回数据项时,这种方法有助于避免触发 API 速率限制。还可以在批次之间配合使用 Wait 节点,进一步降低处理速度。
在所有传入项目被分成批次并传递到工作流中的下一个节点后,“循环项目”节点将停止执行,因此无需添加 IF 节点来停止循环。
节点异常
您需要在工作流程中设计循环的节点和操作:
- CrateDB 对
insert和update执行一次。 - Run Once for All Items 对所有项目运行一次模式下的Code节点:根据输入的代码片段处理所有项目。
- Run Once for All Items 对所有项目运行一次模式下的执行工作流程节点。
- HTTP请求:您必须自己处理分页。如果您的 API 调用返回分页结果,您必须创建一个循环来一次获取一页。
- Microsoft SQL 对
insert、update和delete执行一次。 - MongoDB 对
insert和update执行一次。 - QuestDB 对
insert执行一次。 - Redis:
- Info:无论传入数据包含多少个数据项,此操作都只执行一次。
- RSS Read 对请求的 URL 执行一次。
- TimescaleDB 对
insert和update执行一次。