首先完成“Lesson 4: Custom Transformations with the Code Node”即可解锁本课程。转到上一课

简介

在实际的自动化工作流中,数据很少沿着一条直线流动。你可能在一个分支从 CRM 获取客户记录,在另一个分支从 API 拉取他们的最近订单,然后需要将这两条数据流合并成统一的对象再向下游传递。这正是 Merge 节点所处理的场景。

Merge 节点接受两个单独的输入分支——分别称为输入 1 和输入 2——并按照你选择的策略将它们的项合并。把合并模式设错是 n8n 中最常见的数据问题之一,因为项似乎会合并,但输出并非你所期望的那样。事先理解各模式之间的区别,可以在后续调试中节省大量时间。

两个并行分支(输入 1 和输入 2)汇聚到一个单一的 Merge 节点,然后流向一个输出流的流程图

四种合并模式

N8n 的 Merge 节点提供四种模式:Append、按位置合并、按键合并和 Multiplex。每种模式回答了关于两条分支的项应如何彼此关联的不同问题。

Append 仅将两个列表简单地连接起来。输入 1 的每个项先出现,然后是输入 2 的每个项。不会进行配对。当你想要一个单一的平面列表且两个分支相互独立时使用——例如合并两份不同的邮箱地址列表以发送一个活动。

按位置合并(以前称为按索引合并)按其在列表中的顺序对项进行配对。输入 1 的项 0 与输入 2 的项 0 合并,项 1 与项 1 合并,以此类推。两个项的字段合并为一个对象。如果列表长度不等,输出数量按默认取较短列表的长度。

按键合并使用来自两个分支的共享字段值来匹配项——类似于 SQL 的列上的 JOIN。你在每个输入中指定一个键字段(它们的字段名可以不同),n8n 将找到值匹配的配对。

Multiplex 产生输入 1 与输入 2 的所有可能组合 — 即直积。如果输入 1 有 3 项,输入 2 有 4 项,Multiplex 输出 12 项。这通常不是你想要的,但在生成组合时很有用,例如把每个产品与每个折扣等级配对。

对比图显示并排的 4 种合并模式:Append(两组列表叠加)、按位置合并(按索引配对项)、按键合并(通过共享字段匹配项)、Multiplex(所有组合网格)

实用示例:按 Key 进行合并

假设你的 HTTP Request 节点在一个分支返回客户档案:

json
[
{ "customerId": "C001", "name": "Alice" },
{ "customerId": "C002", "name": "Bob" }
]

而另一个分支的 HTTP Request 返回订单总额:

json
[
{ "id": "C002", "totalSpent": 340 },
{ "id": "C001", "totalSpent": 120 }
]

这些项顺序不同、且同一客户标识符使用不同字段名。在将 Merge 节点设为按 Key 合并时,将 Input 1 的 Key 字段配置为 customerId,将 Input 2 的 Key 字段配置为 id。N8n 将不管顺序如何,将 C001 与 C001、C002 与 C002 匹配,从而产生:

json
[
{ "customerId": "C001", "name": "Alice", "id": "C001", "totalSpent": 120 },
{ "customerId": "C002", "name": "Bob", "id": "C002", "totalSpent": 340 }
]

默认情况下,Input 1 中与 Input 2 无匹配的项会被丢弃。你可以在 Output Type 选项中改变此行为,选择保留 Input 1、Input 2 的未匹配项,或两者 — 相当于 SQL 中的 LEFT、RIGHT 或 FULL OUTER JOIN。

按位置合并示例

按位置合并在你确定两个分支始终会产生相同数量的项且顺序相同的情况下是正确的选择。一个典型情景是分割一个列表,通过并行的两个不同 API 来丰富每一项,然后再将丰富后的结果重新拼接起来。

json
[
{ "userId": 1, "email": "alice@example.com" }
]

若 Input 1 保存的是基础用户记录,Input 2 保存的是来自评分服务的分数:

json
[
{ "score": 87 }
]

按位置合并按索引将它们合并为:

json
[
{ "userId": 1, "email": "alice@example.com", "score": 87 }
]

如果你用 50 位用户的列表对两个分支执行这一步,只要顺序保持不变,所有 50 项都能干净地合并——这在两个分支都从同一个 Batch 的 Split/ SplitOut 节点开始时通常如此。

常见错误

最常见的错误是在两条分支以不同速度处理项或应用筛选时使用按位置合并(Combine by Position),导致列表不同步。合并会悄无声息地将错误的项配对。如果有任何顺序可能不同的情况,请改用按键合并(Combine by Key).

另一个问题是在两个分支都尚未完成执行时触发 Merge 节点。在 n8n 中,Merge 节点会自动等待两条输入到达后再进行处理,但这只有在两条分支都来自同一个上游节点时才能正确工作。如果你把不同的触发路径连接到一个 Merge 节点以期望实现同步,则行为未定义,且常常产生重复执行。

最后,要防止字段名冲突。当两个项具有相同的字段名且你将它们合并时,默认情况下输入 2 的值会覆盖输入 1 的值。如果你需要保留两个值,请在合并前使用 Set 节点在上游重命名冲突字段。

概述

Merge 节点是 n8n 中多分支工作流的骨干。Append 将列表堆叠,Combine by Position 按顺序配对项,Combine by Key 通过共享字段值连接项,Multiplex 生成所有组合。关键的决策总是这两条数据流是否具有结构关系——如果有,使用 Combine by Key 以提高可靠性;如果它们保证有序且长度相等,Combine by Position 更简单。正确选择可以避免一整类微妙的数据完整性错误。

课后练习

课程检查点

巩固所学知识,获取作业反馈。

0/1
已回答 · 0/1