你是不是也在手动比对 Excel，把数据一条条更新进系统？

笔者见过太多这样的场景：每天早上，运营同事都要把后台导出的订单表，和 Excel 里的跟进记录做比对。如果订单号存在，就更新状态；如果不存在，就新增一行。这种机械的“搬运”工作，不仅折磨人，还极易出错。一旦手抖覆盖错数据，几天的活儿都白干了。

在 N8N大学，我们的宗旨就是把这种“脏活累活”彻底自动化。今天，笔者就带你解锁 n8n 中最强大的数据处理模式之一：Merge (Upsert)。学会它，你就能实现“有则更新，无则新增”的丝滑逻辑，让工作流自己长出“脑子”。

什么是“Upsert”？大白话讲透

在聊 n8n 节点之前，我们先用大白话把 Upsert 这个概念拆解开。它其实是 Update（更新）和 Insert（插入）的合成词。

想象一下，你手里有一份名单，要把新名单里的数据录入系统。你的大脑会做如下判断：

• 如果系统里已经有了这个人（匹配成功）：那就更新他的电话号码、地址等信息。
• 如果系统里没有这个人（匹配失败）：那就把整条新记录插入系统，生成一条新数据。

这就是“有则更新，无则新增”。在 n8n 里，我们不写代码，仅靠 Merge 节点的参数配置，就能完美复刻这个逻辑。

核心实操：用 Merge 节点打通数据任督二脉

假设我们要实现这样一个场景：从 Airtable（或任意数据库）读取现有用户列表，然后把从 Webhook 接收到的新用户数据写入。如果邮箱匹配，就更新昵称；如果不匹配，就新增记录。

第一步：准备两条数据流

在工作流中，你需要两条数据输入：

1. 输入1（现有数据）：通常是 Database 节点（如 Airtable、Postgres）或 Spreadsheet File 节点。这是你的“老底子”数据。
2. 输入2（待处理数据）：通常是 Webhook 或 Form Trigger 接收到的新数据。

注意： 在 n8n 的画布上，这两条流是平行的，还没有连接。

第二步：配置 Merge 节点（关键步骤）

这是整个模式的核心。在两条数据流后面，拖入一个 Merge 节点，并按以下参数配置：

• Mode（模式）：选择 “Merge by Key”（根据键合并）。这是实现 Upsert 的魔法开关。
• Input 1 / Input 2：n8n 会自动识别上游的两个节点，确保它们分别对应“现有数据”和“新数据”。
• Join Keys（连接键）：这是判断“有”还是“无”的依据。比如，我们通常用 Email 或 ID 来匹配。在 Input 1 和 Input 2 中分别填入 email。

第三步：开启 Upsert 功能

很多新手在这里会漏掉关键设置。在 Merge 节点的设置中，找到 Options -> Output：

• 勾选 “Include Input 1”（保留老数据字段）。
• 勾选 “Include Input 2”（引入新数据字段）。
• 最重要的一点：如果你的数据源支持自动创建（如 Airtable），可以直接连接后续的 Update 或 Create 节点。

但在 n8n 中，更通用的硬核做法是配合 IF 节点或直接利用 Merge 输出的 pairedItem 特性。不过，最简单的“伪 Upsert”技巧是：

1. Merge 节点设置 Mode: Merge by Key。
2. 下游连接一个 IF 节点。
3. IF 判断：{{$json["your_key_from_input_2"]}} is not empty。
4. True 分支 -> 连接 Update 节点。
5. False 分支 -> 连接 Create 节点。

笔者提示： 在 n8n 中，还有一个更高级的流派是直接使用数据库节点（如 Postgres）的 Upsert 操作。如果你的目标是数据库，直接在 SQL 节点写 ON CONFLICT (id) DO UPDATE SET ... 效率最高。本文主要讲解通用的 n8n 逻辑层处理。

避坑指南：为什么我的数据对不上？

在实战中，笔者见过最多的问题就是“明明邮箱一样，为什么没匹配上？”。

坑点 1：数据格式不统一

Input 1 的 email 是 user@example.com（小写），Input 2 的 Email 是 User@example.com（首字母大写）或者带有空格。虽然看着一样，但机器算作不同数据。

解决办法： 在 Merge 之前，使用 Set 或 Edit Fields 节点，强制把所有用于比对的 Key 转为小写（使用 JS 表达式：{{ $json.email.toLowerCase() }}）。

坑点 2：ID 的自增陷阱

如果你是用 ID 作为 Merge 的 Key，要注意新数据是否携带 ID。如果是新增，通常不需要 ID（由数据库自增）；如果是更新，必须携带 ID。

解决办法： 尽量使用 业务唯一键（如手机号、邮箱、订单号）作为 Key，而不是自增 ID。

FAQ 问答

Q1: Merge 节点和 IF 节点配合使用太麻烦，有更简单的吗？

A: 如果目标是写入支持 Upsert 的数据库（MySQL, PostgreSQL, Airtable），直接在数据库操作节点中寻找 “Upsert” 模式即可，n8n 会帮你处理逻辑。如果是写入 Google Sheets，建议使用 Set 节点配合 Google Sheets 的 “Update row”（按查询）和 “Append row” 组合。

Q2: 数据量很大（几万条），Merge 节点会卡死吗？

A: 会。n8n 默认是在内存中处理这些数据。如果数据量巨大，建议在源头（如 SQL 查询）就过滤好，或者使用 Chunking（分块）处理，不要一次性把几万条数据塞进工作流。

Q3: 为什么我找不到 "Merge by Key" 模式？

A: 确保你连接了两个上游输入源。如果你只连了一个源，Merge 节点会提示你缺少 Input。只有当两个数据流都指向它时，该模式才会启用。

总结与资源

掌握 Merge (Upsert) 模式，是从“只会跑通流程”进阶到“处理复杂业务逻辑”的关键一步。它让 n8n 不再仅仅是一个搬运工，而是一个具备判断力的智能助理。

在 N8N大学 (n8ndx.com)，我们建议你立刻去搭建一个测试工作流：用两个 Manual Trigger 模拟数据，亲手配置一次 Merge 节点。只有亲手踩过坑，才能真正理解数据流动的奥义。