问题复现：Merge 节点的“噩梦”时刻
作为 N8N大学 的主编，笔者在社区里见过太多这样的场景：流程跑了大半，眼看就要成功，却在 Merge 节点突然卡住，报错信息要么是莫名其妙的 Cannot read property，要么是输出的数据量完全不对劲。
最典型的报错代码通常长这样：
- ERROR: Parameter 'Merge Input 1' is empty
- ERROR: Cannot read properties of undefined (reading 'json')
- 或者更隐蔽的：数据丢失（明明输入有数据，输出却为空）。
这些错误通常发生在你试图合并来自两个或多个不同分支的数据时。你以为只要把线连上，数据就会自动手拉手，结果却是数据乱成一团，或者直接“人间蒸发”。
原因分析：为什么 Merge 节点这么难伺候？
用大白话讲，Merge 节点就像是一个十字路口的交通指挥官。它必须严格遵守规则，否则就会撞车。报错的核心原因通常有三点：
第一，输入源不匹配。 n8n 的 Merge 节点默认要求所有输入（Input 1, Input 2...）必须同时到达。如果你的流程设计中，其中一个分支因为逻辑判断（如 IF 节点）没有输出数据，Merge 节点就会一直傻等，直到超时报错。
第二，数据格式“货不对板”。 很多人在合并数据时，忽略了数据结构的差异。比如 Input 1 是 JSON 对象，Input 2 是 数组，或者两者的 Key 完全不一致。Merge 节点在处理这种异构数据时，很容易因为找不到对应的字段而崩溃。
第三，模式选择错误。 Merge 节点有多种合并模式（Append, Merge by Key, Pass-through 等）。如果选了 Append（追加），但数据量级很大，可能会导致内存溢出；如果选了 Merge by Key（按键合并），但字段名拼写错误，数据就会丢失。
解决方案：三招搞定 Merge 节点报错
针对上述问题，笔者总结了三种从易到难的解决方案，建议按顺序尝试。
方案一：调整“输入等待模式” (Wait for Inputs)
这是最基础但最容易被忽视的设置。在 Merge 节点的配置中，找到 “Wait for Inputs” 选项。
- 场景： 如果你的流程中某个分支可能没有数据（例如 API 返回空值），请将此选项设置为 “Wait for the first input to arrive” 或者具体指定等待的输入数量。
- 原理： 这告诉 n8n：“只要有一个分支有数据就立刻执行，不要死等那个没数据的分支。”
方案二：统一数据格式 (Set 节点预处理)
在 Merge 节点之前，插入一个或两个 Set 节点（或 Aggregate 节点），强制统一数据结构。
假设 Input 1 是用户信息（JSON 对象），Input 2 是订单列表（数组）。直接合并会报错。你需要：
- 在 Input 1 后加一个 Set 节点，将 JSON 对象转换为包含该对象的数组（虽然 n8n 有时会自动处理，但显式转换更安全）。
- 确保两个分支的输出都包含一个唯一的 关联键（Key），比如
user_id。
笔者提示： 哪怕你只是想简单追加数据，也建议先用 Set 节点把所有数据的顶层结构检查一遍，确保没有奇怪的嵌套层级。
方案三：使用正确的合并模式 (Merge by Key)
如果你需要将两组数据关联起来（类似 SQL 的 Join），必须使用 “Merge by Key” 模式。
- Key 1： 输入 1 的关联字段（如
email）。 - Key 2： 输入 2 的关联字段（如
contact_email）。
避坑点： 这里的字段名必须完全一致，且数据类型必须相同（都是字符串或都是数字）。如果报错提示 Key 找不到，请先用 Function 节点或 JavaScript 代码节点清洗一遍数据，确保字段名没有多余的空格或大小写问题。
预防措施：构建稳健的自动化流程
为了避免未来再次踩坑，N8N大学 建议养成以下习惯：
- 善用“测试数据”： 在调试 Merge 节点时，不要直接跑全量数据。使用
Test Workflow功能，手动触发少量数据，观察每个分支的输出结构。 - 添加错误处理分支： 在 Merge 节点后连接一个
IF节点，判断输出是否为空。如果为空，走“错误通知”分支（发邮件或钉钉），而不是让流程直接报错停止。 - 慎用“等待所有输入”： 除非你明确知道所有分支都有数据，否则默认设置为等待特定数量的输入，或者使用
Wait节点来同步时间，而不是依赖 Merge 的阻塞等待。
FAQ 问答
Q1: Merge 节点输出的数据量比预期的少，是怎么回事？
A: 这通常是因为你使用了 “Merge by Key” 模式，且两个输入源中只有部分数据拥有相同的 Key。如果 Input 1 有 10 条数据，Input 2 只有 5 条匹配的 Key，那么输出就只有 5 条。建议检查数据源的匹配率。
Q2: 为什么我的 Merge 节点一直显示“Waiting”状态？
A: 流程处于“Waiting”意味着 n8n 正在等待某个分支的数据到达。请检查上游节点（如 HTTP Request 或 IF 节点），确认该分支确实有数据输出，且没有被逻辑判断拦截。如果该分支确实可能没数据，请参考上文的“方案一”。
Q3: 能否在一个 Merge 节点合并超过两个输入？
A: 可以。在 n8n 的 UI 中，你可以拖拽更多的连线到 Merge 节点，或者在节点配置中添加更多的 Input。但请注意，输入越多，逻辑越复杂，出错概率呈指数级上升。建议分批合并（先合并 A 和 B，再将结果与 C 合并）。
总结与资源
归根结底，n8n Merge 节点的报错大多源于数据结构的不一致和输入源的不确定性。只要在合并前做好数据清洗，并正确设置等待模式，90% 的问题都能迎刃而解。
如果你在实战中遇到了更棘手的报错，欢迎访问 N8N大学 (n8ndx.com) 查看更多硬核教程，或者加入我们的社区交流讨论。
