n8n 中文文档

项目链接错误

在 n8n 中,您可以引用任何前面节点的数据。这不一定是紧邻的前一个节点:可以是链中的任何前面节点。当引用更远的节点时,您使用表达式语法 $(node_name).item。

不同数据项的连线示意图。利用数据项链接,您可以通过 `$('Get famous movie actors').item` 获取每部电影的演员。

由于前一个节点中可以有多个项目,因此 n8n 需要知道使用哪一个。当使用 .item 时,n8n 在幕后为您解决这个问题。有关其工作原理的详细信息,请参阅项目链接概念。

如果信息缺失,.item 会失败。为了确定使用哪个项目,n8n 为每个项目维护一个通过工作流节点的线程。对于给定的项目,此线程告诉 n8n 是哪些前面节点中的项目生成了它。要在给定的前面节点中找到匹配的项目,n8n 沿着此线程回溯,直到到达所讨论的节点。

当使用 .item 时,在以下情况下 n8n 会显示错误:

  • 线程断开
  • 线程指向前一个节点中的多个项目(因为不清楚使用哪一个)
  • 你引用的节点与当前数据项位于不同分支

要解决这些错误,您可以避免使用 .item,或者修复根本原因。

您可以通过使用 .first()、.last() 或 .all()[index] 来避免 .item。它们要求您知道您要定位的项目在目标节点的输出项目中的位置。有关这些方法的更多详细信息,请参阅引用先前的节点。

根本原因的修复取决于具体错误。

修复“前一个节点中缺少表达式的信息”

如果您看到此错误消息:

错误:前一个节点中缺少表达式信息

链中有一个节点不返回配对信息。这里的解决方案取决于前一个节点的类型:

  • 代码节点:确保返回节点用于生成每个输出项的输入项。有关更多信息,请参阅在代码节点中保留链接。
  • 自定义或社区节点:节点创建者需要更新节点以返回用于生成每个输出项的输入项。有关更多信息,请参阅节点创建者的项目链接。

修复“表达式的多个匹配项”

这是错误消息:

错误:表达式有多个匹配项

有时 n8n 使用多个项目来创建单个项目。示例包括汇总、聚合和合并节点。这些节点可以组合来自多个项目的信息。

当您使用 .item 并且有多个可能的匹配时,n8n 不知道使用哪一个。要解决此问题,您可以:

  • 请改用 .first()、.last() 或 .all()[index]。有关这些方法的更多详细信息,请参阅引用先前的节点。
  • 引用包含相同信息但没有多个匹配项的不同节点。

修复“节点位于另一个分支”错误

错误消息如下:

ERROR: '<node-name>' is on another branch

你使用 .item 引用的节点位于当前节点上游,但当前数据项并非来自该节点,因此 n8n 无法将当前数据项与该节点中的数据项相匹配。当两个分支重新汇合,但它们的数据项仍保持分离时,就会出现这种情况。

例如,处于 Append 追加模式的 Merge 节点会先输出 Input 1 输入 1 中的数据项,再输出 Input 2 输入 2 中的数据项。每个输出数据项仍然只链接回一个输入。如果 Input 2 输入 2 来自名为 Get orders 的节点,则 {{ $('Get orders').item.json.total }} 对来自 Input 2 输入 2 的数据项能够解析,但对来自 Input 1 输入 1 的数据项会失败。

表达式会解析为 null,节点仍会成功,因此执行不会停止。n8n 会在编辑器的表达式预览中显示错误。

你可以采用以下任一方法解决:

  • 使用 .first()、.last() 或 .all()[index] 代替 .item。有关这些方法的更多详细信息,请参阅引用先前的节点。
  • 如果分支由 Merge 节点汇合,请将其设为 Combine 合并模式,使每个输出数据项都包含两个分支的数据。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。