写在前面：为什么你的 Function 节点总是报错？

在 N8N大学，笔者见过太多新手在编写 Function 节点时，盯着红色的报错信息发呆。你可能已经学会了拖拽节点，但一旦进入代码的世界，JavaScript 的“坑”往往让人措手不及。

别担心，这绝对不是你的逻辑有问题，而是你对 n8n 的运行机制还不够了解。今天，笔者就带你避开那 5 个新手必踩的坑，让你写的代码既稳又快。

坑一：试图修改输入数据（$input）

这是新手最容易犯的错误。在 JavaScript 的世界里，我们习惯了直接修改对象属性。但在 n8n 的 Function 节点中，$input 是不可变的（Immutable）。

如果你尝试写 $input.item.json.name = "new name"，n8n 会直接报错，或者更糟糕的是——静默失败。

正确做法：创建新对象

你需要使用 return 来输出一个新的 JSON 对象。n8n 会基于这个新对象创建新的 Item。

// 错误写法
$input.item.json.status = "processed";

// 正确写法
const newItem = {
  ...$input.item.json, // 展开原有属性
  status: "processed"
};
return newItem;

坑二：不懂异步处理（Async/Await）

Function 节点支持异步代码，但很多新手在处理 HTTP 请求或数据库查询时，忘记了使用 await，导致返回的数据是 Promise 对象而不是实际结果。

这会导致后续的节点接收到一堆乱码，而不是你想要的数据。

正确做法：包裹在 async 函数中

虽然 n8n 允许直接返回 Promise，但为了代码可读性，建议显式地使用 async/await。

async function processItem(item) {
  // 假设这是一个异步操作
  const response = await $http.request({
    method: 'GET',
    url: 'https://api.example.com/data'
  });
  
  return {
    ...item,
    apiData: response.json
  };
}

return processItem($input.item.json);

坑三：忽略多条数据的遍历（Loop）

Function 节点默认处理单个 Item。如果你的上游节点输出了 10 条数据，而你的代码没有写遍历逻辑，那么 n8n 可能只会处理第一条数据，或者抛出异常。

很多新手以为 n8n 会自动循环执行代码，其实不然。

正确做法：使用 for...of 循环

你需要显式地遍历 $input.all()。

const results = [];

// 获取所有输入项
for (const item of $input.all()) {
  const data = item.json;
  
  // 处理逻辑
  const processed = {
    ...data,
    processedAt: new Date().toISOString()
  };
  
  results.push(processed);
}

return results;

坑四：混淆 this 指向

在 n8n 的 Function 节点上下文中，this 的指向并不是全局对象，也不是你想象中的 n8n 实例。如果你依赖 this 来存储状态，你会发现它在每次执行时都是空的。

这是因为 n8n 为了隔离环境，每次执行代码块时都可能创建了新的上下文。

正确做法：使用闭包或外部变量（慎用）

虽然在某些配置下可以使用 this，但为了代码的可移植性和稳定性，尽量避免依赖它。如果需要跨 Item 传递数据，考虑使用 Set 节点 或 记忆节点（Memory），而不是在 Function 节点里硬扛。

坑五：不知道如何访问二进制数据

当你的工作流涉及文件处理（如图片、PDF）时，新手往往找不到文件数据在哪。Function 节点中，二进制数据并不在 $input.item.json 里，而是在 $input.item.binary 中。

如果你试图在 JSON 里找文件流，注定是徒劳的。

正确做法：操作 binary 对象

如果你想修改二进制数据（比如重命名文件），你需要操作 binary 属性。

const newItem = {
  json: $input.item.json,
  binary: {
    data: {
      ...$input.item.binary.data,
      fileName: "renamed_file.jpg"
    }
  }
};

return newItem;

FAQ：新手常见疑问解答

1. Function 节点和 Code 节点有什么区别？

在 n8n 中，这两个通常指的是同一个东西（Function Node）。但在旧版本或某些上下文中，Code 节点可能特指允许编写更复杂逻辑的版本。目前主流版本中，Function 节点就是你编写 JavaScript 的地方。

2. 为什么我的代码在测试时能跑，运行时却报错？

这通常是因为数据结构不一致。测试时你可能只输入了一条数据，而实际运行时上游传来了多条数据。请务必检查你的代码是否处理了 $input.all() 的情况。

3. Function 节点能调用外部库吗？

标准的 n8n Function 节点运行在沙箱环境中，通常只支持原生 JavaScript API（如 Math, Date）。如果你想引入第三方库（如 lodash 或 moment），通常需要使用 Code 节点（Python/JavaScript） 或者在自托管环境中配置白名单，这对新手来说比较复杂，建议先用原生 JS 实现。

总结与资源

避开这 5 个坑，你的 n8n 自动化之路会顺畅很多。记住，Function 节点是 n8n 的瑞士军刀，但用好它需要你对 JavaScript 和 n8n 的数据流转有清晰的认知。

如果你在实践中遇到了其他棘手的报错，欢迎访问 N8N大学 (n8ndx.com) 查阅更多硬核教程，或者在社区留言，笔者会第一时间回复。