跳转至

错误处理#

在设计工作流逻辑时,考虑潜在的错误并设置方法来优雅地处理它们是一个好习惯。通过错误工作流,您可以控制 n8n 如何响应工作流执行失败。

调查错误

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

创建和设置错误工作流#

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

您可以为多个工作流使用同一个错误工作流。

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

错误数据#

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[
	{
		"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{} 中的信息较多:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "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实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持