n8n 中文文档

常见问题

以下是 代码节点 的一些常见错误和问题以及解决或排除这些问题的步骤。

代码未正确返回项目

当您的 Code 代码节点中的代码未以预期格式返回数据时,会出现此错误。

在 n8n 中,节点之间传递的所有数据都是对象数组。这些对象中的每一个都包装了另一个带有 json 键的对象:

[
  {
    "json": {
      // your data goes here
    }
  }
]

要解决此错误,请检查以下内容:

  • 阅读数据结构,了解Code节点接收的数据以及节点输出数据的要求。
  • 了解数据项如何工作以及如何使用项链接连接来自先前节点的数据项。

'json' 属性不是对象

当 Code 代码节点返回 json 键未指向对象的数据时,会出现此错误。

如果您将 json 设置为不同的数据结构(如数组),可能会发生这种情况:

[
  {
    "json": [
      // Setting `json` to an array like this will produce an error
    ]
  }
]

要解决此问题,请确保 json 键在您的返回数据中引用一个对象:

[
  {
    "json": {
      // Setting `json` to an object as expected
    }
  }
]

代码不返回对象

当您的 Code 代码节点未返回任何内容或返回意外结果时,可能会出现此错误。

要解决此问题,请确保您的代码节点返回预期的数据结构:

[
  {
    "json": {
      // your data goes here
    }
  }
]

如果您提供的代码返回 'undefined' 而不是预期结果,也可能出现此错误。在这种情况下,请确保您在 Code 代码节点中引用的数据在每次执行中都存在,并且具有您代码期望的结构。

'import' 和 'export' 只能出现在顶层

如果您尝试在 Code 代码节点中使用 import 或 export,会出现此错误。n8n 的 JavaScript 沙箱不支持这些。相反,请使用 require 函数加载模块。

要解决此问题,请尝试将您的 import 语句更改为使用 require:

// Original code:
// import express from "express";
// New code:
const express = require("express");

找不到模块 '\'

如果您尝试在 Code 代码节点中使用 require 而 n8n 找不到模块,会出现此错误。

警告

Only for self-hosted 仅适用于自托管

n8n不支持在云版本中导入模块。

如果您是自托管 n8n,请按照以下步骤操作:

  • 将模块安装到您的 n8n 环境中。
  • 如果您使用 npm 运行 n8n,请在与 n8n 相同的环境中安装该模块。
  • 如果您使用 Docker 运行 n8n,则需要使用包含您的模块的 自定义映像 来扩展官方 n8n 映像。
  • 设置 NODE_FUNCTION_ALLOW_BUILTIN 和 NODE_FUNCTION_ALLOW_EXTERNAL 环境变量 以允许导入模块。

使用全局变量

有时您可能希望设置和检索与工作流相关的简单全局数据,跨执行和执行内。例如,在编译包含项目更新列表的报告时,您可能希望包含上一个报告的日期。

要直接在工作流中设置、更新和检索数据,请使用代码中的静态数据 函数。您可以全局管理数据或绑定到特定节点的数据。

提示

Use Remove Duplicates when possible 尽可能使用删除重复项

如果您有兴趣使用变量来避免多次处理相同的数据项,请考虑使用删除重复节点。 “删除重复项”节点可以在执行过程中保存信息,以避免多次处理相同的项目。

无法访问代码节点 中的凭据

按照设计,Code 代码节点无法访问凭据。它们无权访问 n8n 的内部凭据管理系统。这是为了防止敏感认证数据的泄露。

尝试使用 this.getCredentials() 或 $getCredentials() 等表达式或方法引用代码节点中的凭据将导致错误,例如 this.getCredentials is not a function 和 $getCredentials is not defined。

如果您需要进行经过身份验证的 API 调用,请使用提供凭据支持的 HTTP 请求节点。

要动态使用凭据,请在 Code 代码节点之外处理凭据选择逻辑:

  • 使用 Switch 节点路由到具有不同凭据的不同节点。
  • 直接在凭证字段中使用表达式,根据先前的节点数据动态选择凭证。
  • 使用具有自定义身份验证的 HTTP 请求节点,通过表达式动态设置标头、查询参数或正文值。
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。