为什么你的 n8n 数据流总是报错？可能是 Set 节点没用对
笔者经常在 N8N大学 的社群里看到这样的问题：“HTTP 请求拿到了 JSON 数据，为什么下游节点说找不到字段？”或者“数据嵌套太深，Set 节点里写了一长串路径，又长又容易出错。”
事实上，n8n 的 Set 节点不仅仅是一个简单的“赋值”工具，它是清洗混乱 JSON 数据、构建清晰工作流的基石。如果你还在手动拼接 JSON 字符串，或者在代码节点里写大段 JavaScript，那么这篇文章就是为你准备的。
今天，N8N大学 就带你从混乱的 JSON 结构中突围，掌握 Set 节点提取数据的实战技巧，让你的自动化流程既稳健又优雅。
理解 Set 节点的两种模式：Fixed vs JSON
在深入实战之前，我们必须先搞清楚 Set 节点的两个核心工作模式，这是很多新手容易混淆的地方。
1. Fixed Mode（固定模式）
这是最直观的模式。你在这里定义“键（Key）”和“值（Value）”。它适合处理结构非常规整、层级不深的数据。比如，你想从一个对象中提取出 user_id 和 email，直接在这里映射即可。
2. JSON Mode（JSON 模式）
这是处理复杂、深层嵌套数据的“大杀器”。你只需要在输入框里写标准的 JSON 语法，n8n 会自动将其解析为对象。当你需要从一个深埋在数组里的对象提取字段时，这个模式能让你少写很多行代码。
实战技巧一：从嵌套结构中“打捞”数据
假设我们收到了一个复杂的 API 响应，结构如下：
{
"status": "success",
"data": {
"users": [
{
"id": 101,
"profile": {
"name": "张三",
"contact": "zhang@example.com"
}
}
]
}
}
我们的目标是提取出 name 和 contact。如果使用 Fixed 模式，你需要写 data.users[0].profile.name，路径太长且容易出错。
使用 JSON 模式 的步骤如下：
- 在 Set 节点中选择 JSON 模式。
- 在输入框中直接写：
{
"userName": "{{$json.data.users[0].profile.name}}",
"email": "{{$json.data.users[0].profile.contact}}"
}
这样，无论上游数据结构多复杂，你都能像“钓鱼”一样，通过 n8n 的表达式语法（使用 $json）直接把精确字段提取出来，输出结构干净整洁。
实战技巧二：处理数组数据与批量提取
如果 users 数组里不止一个人，而是有 100 个人，我们该怎么办？硬写索引（如 [0]、[1]）显然不现实。
这时候，单靠 Set 节点是不够的，我们需要配合 Split Out（拆分） 操作，但在 Set 节点中，我们通常先做“降维”处理。
场景： 提取所有用户的 ID 列表。
在 Set 节点的 JSON 模式下，我们可以利用 n8n 的表达式函数：
{
"all_ids": "={{$json.data.users.map(user => user.id)}}"
}
这里的 = 符号至关重要，它告诉 n8n 这是一个 JavaScript 表达式，需要执行计算，而不是简单的字符串映射。
如果你希望为每个用户生成一条独立的消息（即拆分数组），通常建议在 Set 节点之前或之后使用 Split Out 节点，或者在 HTTP Request 节点中直接开启“Split Out Items”选项。但在数据清洗阶段，Set 节点负责把数据整理成标准的 JSON 格式，是后续处理的前提。
实战技巧三：处理缺失字段与默认值
在实战中，API 返回的数据往往不稳定。有时有 phone 字段，有时没有。如果直接提取，下游节点可能会因为字段缺失而报错。
在 Set 节点中，我们可以利用 n8n 表达式强大的容错能力。例如，提取电话号码，如果没有则设为 null 或空字符串：
{
"phone": "={{$json.contact_info?.phone || 'N/A'}}"
}
注意： 这里使用了可选链操作符 ?. 和逻辑或运算符 ||。这是硬核玩家的必备技能。它确保了即使 contact_info 对象不存在，表达式也不会报错，而是优雅地返回默认值 N/A。
这比在 Code 节点里写 if (json.contact_info && json.contact_info.phone) ... 要简洁得多，也更符合 n8n 的设计哲学。
避坑指南：Set 节点最常见的 3 个错误
即使你懂了原理，实操中仍有不少坑。以下是 N8N大学 总结的高频报错点：
- 路径错误： 很多时候报错
Cannot read property 'xxx' of undefined，是因为表达式路径写错了。建议点击输入框旁边的 Expression 面板，利用左侧的 JSON 树形图点击生成路径，避免手误。 - 忘记加等号： 在 JSON 模式下，如果你需要计算（比如把字符串转数字），必须在值的最前面加上
=。例如"count": "={{$json.value * 10}}"，漏掉等号它就只是个字符串"{{$json.value * 10}}"。 - 数据类型混淆： n8n 很智能，但有时也“傻”。如果你提取的字段是数字，但你在 Set 节点里没加
=也没明确转换，它可能会被当成字符串传递，导致后续计算错误。养成在 Set 节点明确数据类型的好习惯。
FAQ：关于 Set 节点提取数据的常见问题
Q1: Set 节点和 Code 节点有什么区别？我该用哪个？
简单数据提取用 Set 节点，性能更好，可视化更强。只有在需要极其复杂的逻辑判断（如多重循环嵌套）或使用第三方库时，才考虑 Code 节点。N8N大学 建议 90% 的场景优先使用 Set 节点配合表达式。
Q2: 为什么我提取的 JSON 数据在 Excel 导出时格式乱了？
这通常是因为 Set 节点输出的值是对象或数组，而 Excel 节点需要扁平化的字符串。在 Set 节点中，你可以使用 JSON.stringify() 函数将对象转为字符串，或者在 Excel 节点设置中开启“解析 JSON”选项。
Q3: 如何从 JSON 数组中提取特定条件的数据？
利用 n8n 表达式的 filter 方法。在 Set 节点 JSON 模式下写：
"active_users": "={{$json.users.filter(u => u.status === 'active')}}"
这能让你在不写代码的情况下实现高级筛选。
总结与资源
掌握 n8n 的 Set 节点，本质上是掌握如何与不规则的数据“对话”。从固定模式的快速映射，到 JSON 模式的深度挖掘，再到表达式的容错处理，这些技巧能让你在面对任何混乱的 JSON 结构时都游刃有余。
如果你在实操中遇到了棘手的节点报错，或者有更复杂的 JSON 处理需求，欢迎访问 N8N大学 (n8ndx.com) 查阅更多深度教程。自动化之路没有终点，但有了正确的工具和思维，每一步都会走得更稳。
