Code 节点报错？别慌，这是进阶的必经之路

作为 N8N大学 的首席主编，笔者见过太多新手在 Code 节点面前“翻车”。当你看着满屏的红色错误提示，或者 workflow 突然静默停止时，那种挫败感我太懂了。

但请记住：Code 节点是 n8n 的“瑞士军刀”，也是最容易出错的地方。因为这里运行的是你的 JavaScript 代码，任何语法错误、逻辑漏洞都会直接导致节点崩溃。今天，这篇实战记录就是带你从“报错小白”进阶为“调试老手”的指南。

问题复现：常见的报错现场

在 n8n Code 节点中，报错通常不是凭空出现的。它们往往隐藏在三种场景里：

• 语法错误：最基础的，比如漏了分号、括号不匹配，或者使用了不支持的 ES6 语法。
• 逻辑陷阱：代码能跑通，但输出的数据结构不符合预期，导致下游节点报错。
• 空值崩溃：试图访问 item.json.data，但 data 字段根本不存在。

最典型的报错代码长这样：
ERROR: Cannot read property 'json' of undefined
或者
SyntaxError: Unexpected token

这些报错往往在 Test workflow（测试工作流）时弹窗出现，或者在 Execution log（执行日志）里显示为红色的叉号。

原因分析：为什么 Code 节点这么难搞？

用大白话说，Code 节点就是一个运行在浏览器沙箱里的微型 Node.js 环境。它很强大，但也很脆弱。

1. 数据流向的“断层”
n8n 的数据流转是基于 Item（条目）的。如果你的 Code 节点配置为“为每个 Item 运行”，但你忘记处理空数组或单个 Item 的情况，代码就会崩。笔者见过太多人直接写 input[0].json，结果上游数据为空，直接报错。

2. 异步处理的陷阱
虽然 n8n 的 Code 节点支持异步操作（返回 Promise），但很多新手混淆了同步和异步的写法。如果你没有正确使用 async/await 或者 return new Promise，数据可能还没生成就流到了下一个节点。

3. 环境限制
n8n 的 Code 节点基于 Vue.js 的数据响应式机制。这意味着你不能直接修改深层嵌套的对象，或者使用某些原生的 DOM 操作 API（因为这是无头环境）。

解决方案：三步调试法实战

面对报错，不要盲目改代码。遵循 N8N大学 总结的“三步调试法”，能帮你解决 90% 的问题。

第一步：善用 console.log（调试的黄金法则）

在 n8n 的 Code 节点里，console.log() 是你最好的朋友。不要只看报错信息，要学会“打印”数据流。

在你的代码中插入调试信息：

// 不要只写逻辑，先打印看看
console.log('输入数据长度:', items.length);
console.log('第一条数据结构:', JSON.stringify(items[0].json));

// 你的业务逻辑...
return [{ json: { result: true } }];

执行工作流后，点击节点查看 Details -> Output。你会看到控制台的输出。这能帮你确认数据是否如预期般进入节点。

第二步：防御性编程（处理空值）

永远不要假设上游数据是完美的。在 Code 节点中，养成检查数据存在的习惯。

错误示范：
const name = items[0].json.user.name; —— 如果 user 字段缺失，直接报错。

正确示范：
使用可选链操作符（如果 n8n 版本支持）或逻辑判断。

// 安全的访问方式
const userName = items[0]?.json?.user?.name || 'Unknown';

// 或者遍历并过滤空值
const validItems = items.filter(item => item.json && item.json.id);
return validItems.map(item => ({ json: { ...item.json } }));

这种写法能极大降低 Cannot read property 类错误的发生概率。

第三步：数据结构标准化（返回值的陷阱）

Code 节点的输出必须是特定格式的数组。常见的报错是返回了单个对象，或者返回了 undefined。

确保你的代码最后总是返回一个数组，数组里每个元素都是 { json: { ... } } 的形式。

// ✅ 正确
return [{ json: { foo: 'bar' } }];

// ❌ 错误：返回了单个对象
return { foo: 'bar' };

// ❌ 错误：返回了非 JSON 对象
return [{ data: { foo: 'bar' } }]; // 注意：外层必须是 json 键

如果你需要返回多个数据项，记得保持数组结构：
return [{ json: { id: 1 } }, { json: { id: 2 } }];

预防措施：建立你的调试习惯

为了避免未来再次踩坑，N8N大学 建议建立以下习惯：

1. 分段测试
不要把复杂的逻辑全写在一个 Code 节点里。将数据清洗、逻辑计算、格式转换拆分成多个 Code 节点。这样，当报错发生时，你可以精准定位是哪一步出了问题。

2. 开启“继续执行失败”
在调试阶段，点击工作流右上角的设置，开启 On error -> Continue（遇到错误继续执行）。这样即使某个节点报错，你也能看到后续节点的执行情况，而不是整个流程直接挂掉。

3. 善用“Fixed”功能
在 Code 节点的设置里，有一个 Keep Remote Properties（保留远程属性）选项。如果你的目的是新增字段而不是覆盖整个 JSON，记得勾选它。否则，你可能会丢失上游传过来的重要 ID。

FAQ 常见问题解答

Q1：Code 节点报错 “JavaScript out of memory” 怎么办？
这通常是因为处理的数据量太大，或者代码中存在死循环。尝试分批处理数据（使用 Split in Batches 节点），或者优化代码中的循环逻辑。如果是在本地运行 n8n，尝试增加 Node.js 的内存限制。

Q2：为什么我在 Code 节点里写的 console.log 看不到输出？
请确保你点击的是节点的 Details 面板，而不是简单的查看结果。此外，如果你的代码因为语法错误在执行前就崩溃了，日志可能不会显示。先修复语法错误，再看日志。

Q3：Code 节点可以引入第三方库吗？
在 n8n 的标准 Code 节点中，通常只支持原生的 JavaScript API。如果你需要使用如 moment、lodash 等库，你需要在 n8n 的自定义节点开发中进行配置，或者使用 HTTP Request 节点调用外部 API 来处理。

总结与资源

Code 节点的报错是 n8n 自动化进阶的“拦路虎”，也是“试金石”。掌握 console.log 调试法、学会防御性编程、严格遵守数据结构规范，你就能驾驭这把瑞士军刀。

在 N8N大学，我们相信每一次报错都是优化工作流的机会。如果你在实战中遇到了棘手的 Code 节点问题，欢迎在评论区留言，笔者会挑选典型案例进行深度解析。

更多硬核 n8n 教程，请持续关注：n8ndx.com。