成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

n8n 工作流错误处理配置简报

按 Error workflow、Error Trigger 载荷差异与 Stop and Error 强制失败,生成工作流失败可观测与告警接线简报;不代改生产工作流。

场景说明

面向独立开发者与自动化运维:把 n8n「跑挂了没人知道」写成可配置的错误处理清单,区别于通用 HTTP 重试或云厂商告警规则。

案例叙事

01他们做了什么

自动化工作流最怕「半夜挂了,第二天客服先发现」。很多人只加重试,却没接 Error workflow,失败执行静默落库。

n8n《Handle errors gracefully》说明:设计流逻辑时应考虑潜在错误并优雅处理;通过 Error workflow 可控制执行失败后的响应(例如发邮件或 Slack)。每个工作流可在 Workflow Settings 指定 Error workflow,失败时运行;该工作流必须以 Error Trigger 为第一个节点,且可被多个主流程复用。设置步骤:新建含 Error Trigger 的工作流并保存;在主流程 Options → Settings → Error workflow 选中后保存。Error Trigger 默认载荷含 execution(id/url/retryOf/error/lastNodeExecuted/mode)与 workflow(id/name);execution.id 与 url 需执行已入库,若错误出在主流程触发节点则工作流未真正执行,这两项可能缺失;retryOf 仅当本次是失败重试时出现。触发节点失败时载荷形态不同:execution 信息更少,更多在 trigger.error(含 WorkflowActivationError 等)与 trigger.mode。亦可用 Stop and Error 节点在自定条件下强制失败以触发 Error workflow(常见失败另含节点配置错误、内存耗尽等)。调查时可看 Executions、把历史执行数据载入当前流,或启用 Log streaming。本场景据此输出配置简报。禁止声称「已自动接通告警」。

02实际效果

  • 源未披露量化「接上 Error workflow 后平均发现时延」;公开文只描述设置步骤、载荷字段差异与 Stop and Error。
  • 值班能区分「触发节点失败」与「中段节点失败」该看哪类字段。
  • 有可勾选接线清单,减少「只有成功路径」。

03值得知道

  • Cloud/自托管 n8n 版本与菜单文案可能略有差异,以当前文档为准。
  • Error workflow 本身失败不会无限递归替你兜底,需单独观测。
  • 上面写的是文档能力说明,不是你的实例执行统计。

04可复制提示词

n8n Error workflow 接线简报

你是 n8n 错误处理配置助手。只根据用户现状给接线简报,不要编造已改工作流。

主流程摘要:{{workflow_summary}}
是否已设 Error workflow:{{has_error_workflow}}
失败现象:{{symptom}}
告警渠道偏好:{{alert_channel}}

输出 Markdown:
1. 是否建议新建/复用 Error Handler(Error Trigger 开头)
2. Settings 接线步骤核对
3. 触发节点失败 vs 中段失败:载荷差异与排查提问
4. 是否适合加 Stop and Error 的场景提问
禁止声称已保存设置;禁止索要 API Key。

失败执行复盘提纲

n8n 执行失败且告警未达预期,请写复盘提纲。

execution 摘要:{{execution_brief}}
Error workflow 行为:{{error_wf_behavior}}
时间线:{{timeline}}

输出:
1. 可能根因分层(未接线、触发节点失败载荷、Error 流自身失败、未入库缺 id/url)
2. 要在 Executions / Log streaming 看什么
3. 临时缓解
4. 防再发
不要伪造「零失败」。

05一手来源

怎么做

  1. 粘贴主流程触发方式、是否已设 Error workflow、失败现象与告警渠道
  2. Agent 输出:Error workflow 接线步骤、触发节点失败 vs 中段失败的载荷差异、Stop and Error 适用提问
  3. 人工在 n8n 保存设置;Agent 不代改节点或凭证

实用提示

  • Error workflow 必须以 Error Trigger 开头;可多主流程复用同一错误处理流
  • 与 webhook-signature-verify-fail-triage / api-throttle-quota-incident-runbook 不同:本条是 n8n 执行失败的流程内错误处理,不是下游 HTTP/配额事故
#n8n#工作流#错误处理#Error Trigger#自动化