n8n 中文文档

错误处理

设计流程逻辑时,最好考虑潜在错误并设置妥善的处理方式。您可以使用错误工作流控制 n8n 如何响应工作流执行失败。

提示

Investigating errors 调查错误

要调查失败的执行,您可以:

如何设置错误工作流程?

对于每个工作流程,您可以在 Workflow Settings 工作流程设置 中设置错误工作流程。如果执行失败,它就会运行。这意味着您可以在工作流程执行错误时发送电子邮件或 Slack 警报。错误工作流程必须以错误触发器 开始。

您可以对多个工作流程使用相同的错误工作流程。

  1. 创建一个新的工作流,将错误触发器作为第一个节点。
  2. 为工作流程命名,例如 Error Handler。
  3. 选择Save 保存。
  4. 在要使用此错误工作流程的工作流程中:
    1. 选择 Options 选项 Options menu icon > Settings 设置。
    2. 在 Error workflow 错误工作流程 中,选择您刚刚创建的工作流程。例如,如果您使用名称“错误处理程序”,请选择 Error handler 错误处理程序。
    3. 选择Save 保存。 现在,当此工作流出错时,相关的错误工作流将运行。

错误工作流程会收到哪些数据?

错误触发器接收到的默认错误数据为:

[
    {
        "execution": {
            "id": "231",
            "url": "https://n8n.example.com/execution/231",
            "retryOf": "34",
            "error": {
                "message": "Example Error Message",
                "stack": "Stacktrace"
            },
            "lastNodeExecuted": "Node With Error",
            "mode": "manual"
        },
        "workflow": {
            "id": "1",
            "name": "Example Workflow"
        }
    }
]

所有信息始终存在,除了:

  • execution.id:需要将执行保存在数据库中。如果错误发生在主工作流的触发器节点中,则不存在,因为工作流不会执行。
  • execution.url:需要将执行保存在数据库中。如果错误发生在主工作流的触发器节点中,则不存在,因为工作流不会执行。
  • execution.retryOf:仅在执行是失败执行的重试时存在。

如果错误是由主工作流的触发器节点引起的,而不是后续阶段,发送到错误工作流的数据是不同的。execution{} 中的信息较少,trigger{} 中的信息较多:

{
  "trigger": {
    "error": {
      "context": {},
      "name": "WorkflowActivationError",
      "cause": {
        "message": "",
        "stack": ""
      },
      "timestamp": 1654609328787,
      "message": "",
      "node": {
        . . .
      }
    },
    "mode": "trigger"
  },
  "workflow": {
    "id": "",
    "name": ""
  }
}

如何使用 Stop and Error 节点让工作流程主动失败?

当您创建并设置错误工作流程时,n8n 会在执行失败时运行它。通常,这是由于节点设置错误或工作流程内存不足等原因造成的。

您可以将 Stop And Error 节点添加到工作流中,使执行在您指定的情况下失败并触发错误工作流。

相关资源

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