问题复现：Set 节点“报红”的瞬间，你是不是也头皮发麻？
笔者在 N8N 大学的后台收到了大量类似的求助。场景通常很相似：你正在构建一个自动化流程，手头有一段杂乱的数据（比如来自 Webhook 的字符串，或者 API 返回的非标准 JSON）。
你把它丢进 Set 节点，试图通过 **JSON.parse()** 或者修改表达式将其整理成规整的 JSON 对象。结果一运行，节点下方直接亮起刺眼的红色感叹号。
报错信息通常长这样：
ERROR: JSON.parse: unexpected character at line 1 column 1或者更让人摸不着头脑的：
ERROR: Cannot read property 'xxx' of undefined
这种报错不仅让流程中断，更让人抓狂的是，你看着表达式里明明写的是对的，为什么 n8n 还是不认？别急，这通常不是 n8n 的 bug，而是我们忽略了一些数据底层的“潜规则”。
原因分析：为什么 Set 节点的 JSON 转换总是“翻车”？
在用 Set 节点处理数据时，n8n 默认会在后台进行大量的隐式转换。但当你的源数据不那么“干净”时，转换就会失败。经过 N8N 大学的大量实战测试，主要有以下三个“隐形杀手”：
1. 隐形的字符编码陷阱
很多 API 返回的数据，看似是 JSON，但其实包含不可见的特殊字符。最典型的是 u200b（零宽度空格）或者 BOM 头（字节顺序标记）。这些字符肉眼看不见，但当你尝试用 JSON.parse() 解析时，解析器会直接报错，因为 JSON 标准要求第一个字符必须是 {、[ 或双引号。
2. 数据类型的“假象”
Set 节点的表达式非常智能，但也因此容易产生混淆。比如，你从数据库拿到一个数字字段 123，但在传输过程中，它可能变成了字符串 "123"。如果你在 Set 节点中强行将其作为 JSON 对象处理，或者试图进行数学运算，n8n 可能会因为类型不匹配而报错。
更糟糕的是，如果你直接把一个字符串类型的 JSON 对象赋值给一个键，n8n 可能会自动帮你加转义双引号，导致最终结果变成了 "{"key": "value"}"（双层引号），这在后续节点调用时会直接解析失败。
3. 嵌套结构的表达式陷阱
当你在 Set 节点中使用“从表达式设置”时，如果表达式返回的是一个对象，但你忘记在 JSON 选项卡下勾选对应的设置，或者表达式本身的路径指向了一个 null 或 undefined 的父级，n8n 就无法构建出合法的 JSON 结构。
解决方案：三招搞定 Set 节点的 JSON 转换难题
针对上述问题，笔者为你准备了从简单到进阶的三种解决方案。请根据你的具体场景选择。
方案一：使用“去除空格”与“强制清洗”表达式（最快）
如果你确定数据源是合法的 JSON 字符串，只是包含杂音，可以在 Set 节点的表达式中使用 JavaScript 进行预处理。
操作步骤：
- 在 Set 节点中，选择 从表达式设置 (Set from expression)。
- 在字段名称中输入你想导出的 Key（例如
cleanData）。 - 在值表达式中，不要直接写变量，而是包裹一层清洗逻辑：
假设你的原始数据在 {{ $json.raw_data }} 中，表达式可以这样写：
try {
return JSON.parse($json.raw_data.trim().replace(/u200b/g, ''));
} catch (e) {
return { error: e.message, original: $json.raw_data };
}
解析： 这里用了 trim() 去除首尾空格，用 replace(/u200b/g, '') 去除零宽度空格，最后用 try-catch 防止报错导致流程崩溃。这是 N8N 大学推荐的“防御性编程”写法。
方案二：切换至“JSON”选项卡（最稳）
Set 节点有两个模式：JSON 和 String。很多新手容易在这里选错。
操作步骤：
- 选中 Set 节点，点击右侧的 Parameters（参数）。
- 你会看到一个下拉菜单，默认可能是 String 或者 Binary。请务必切换到 JSON。
- 在 JSON 编辑器中，直接输入你的键值对。如果值是一个对象，确保使用双引号包裹键名。
避坑点： 如果你要把一个已经存在的 JSON 字段（例如 {{ $json.user_info }}）直接作为结果输出，不要手动去写 JSON.parse()。在“JSON”模式下，n8n 会自动识别变量中的对象结构。你只需要把表达式填入 Value 即可。
方案三：使用 Code 节点进行“外科手术式”清洗（最彻底）
如果 Set 节点的表达式功能不足以处理复杂的逻辑（例如需要遍历数组并修改每个对象的结构），请果断使用 Code 节点。Code 节点是 n8n 中处理 JSON 转换的终极武器。
操作步骤：
- 在你的流程中，Set 节点之前或之后插入一个 Code 节点。
- 选择语言为 JavaScript。
- 编写如下逻辑：
const rawData = items[0].json.your_data_field;
try {
// 如果数据是字符串，先解析
let parsedData = typeof rawData === 'string' ? JSON.parse(rawData) : rawData;
// 在这里进行你的深度修改，例如添加新字段
parsedData.processed_at = new Date().toISOString();
// 必须返回一个数组，n8n 的 Code 节点要求这样
return [{ json: parsedData }];
} catch (error) {
console.error("JSON解析失败:", error);
// 返回空或错误信息，防止流程挂起
return [];
}
解析： Code 节点允许你使用原生 JavaScript 的所有能力。你可以在这里做严格的类型检查（typeof），处理 undefined 的情况，并灵活地重组 JSON 结构。这是解决顽固报错的最彻底方法。
预防措施：养成良好的数据处理习惯
为了避免未来在 Set 节点中再次遇到 JSON 格式转换错误，N8N 大学建议你养成以下习惯：
- 善用“Test Step”（单步测试）： 不要等到整个流程跑完才看结果。在 Set 节点点击“Execute Step”，查看 Input 和 Output 的数据结构是否符合预期。
- 前置校验： 在处理数据前，先加一个简单的 Function 或 Code 节点，打印出数据的数据类型（
typeof）和内容。这能帮你快速定位是字符串还是对象。 - 理解 n8n 的数据流转： 记住，n8n 的核心是 JSON。所有的节点输入输出本质上都是 JSON 数组。只要你的思维模式从“处理表格”转变为“处理 JSON 对象流”，报错率会直线下降。
FAQ 问答
Q1: Set 节点和 Code 节点在处理 JSON 时有什么区别？
A: Set 节点适合简单的键值对映射和基础的表达式计算，界面直观。而 Code 节点适合复杂的逻辑处理、循环遍历或需要严格类型转换的场景。如果你在 Set 节点里写很长的 JS 代码，不如直接用 Code 节点，可读性更好。
Q2: 为什么我的 JSON.parse() 报错说“Unexpected token u”？
A: 这通常是因为你试图解析一个实际上是 undefined 的值。在 n8n 的表达式中，如果路径不存在，变量就是 undefined。请在解析前加一个判断：if (myVar) { JSON.parse(myVar) }。
Q3: Set 节点能直接处理二进制数据（如图片）吗？
A: 不能。Set 节点主要用于处理 JSON 数据（文本、数字、布尔值等）。二进制数据（如图片、PDF）需要通过 Read Binary File 或 HTTP Request 节点获取，然后传递给后续节点（如 Google Drive 上传节点）。不要试图在 Set 节点里修改二进制数据。
总结与资源
n8n 的 Set 节点虽然看似简单，但它是数据清洗的重镇。JSON 转换出错，本质上是数据类型不匹配或源数据不纯净导致的。通过理解 JavaScript 的类型系统，并灵活运用 Code 节点，你完全可以驾驭任何复杂的数据结构。
如果你在 n8n 的使用过程中还有其他疑问，欢迎访问 N8N大学 (n8ndx.com) 查阅更多实战教程。在这里，我们不讲正确的废话，只讲能落地的自动化干货。
