n8n 工作流失败处理：错误队列、有限重试和人工补跑
可追踪的错误队列和只补跑必要步骤的操作记录。
适用场景用 Error Trigger 收集自动失败，区分认证、限流与业务校验，记录原执行 ID 和已完成步骤；附错误队列 CSV，避免整个流程盲目重跑。
用 Error Trigger 收集自动失败，区分认证、限流与业务校验，记录原执行 ID 和已完成步骤；附错误队列 CSV，避免整个流程盲目重跑。
来源 · JevLog 编辑部 · 本站原创
原文封面 · n8n
2026-10-02 新增：依据当前官方文档整理，附本站编写练习。未做真实服务调用；来源首次发布日期未确认。
背景 / 问题
Section titled “背景 / 问题”流程跑到一半失败，要知道分类、写入、通知哪些已完成。从头重跑可能再次发消息。先持久记步骤状态，再建立失败队列和按步骤补跑的规则。
-
使用可编辑 n8n 实例，下载 workflow-error-register.csv；先用虚构任务。
-
用 Manual Trigger 与 Stop And Error 练分支，再验证受控自动执行，不接真实付款或客户通知。
JevLog 原创流程图，非产品截图或实测结果。
1. 给每条输入记步骤状态
Section titled “1. 给每条输入记步骤状态”item_id 关联 received、classified、saved、notified 或 failed。不能只用画布临时变量；刷新和补跑都要读持久状态。只有分类失败就只重跑分类，不把已发通知再发一次。
2. 新增错误工作流并绑定
Section titled “2. 新增错误工作流并绑定”以 Error Trigger 开始，Edit Fields 整理工作流名、执行 ID、错误摘要和最后节点，写入表或数据库。在主流程设置选择 Error handler。界面名称随版本变化，以官方文档为准。
3. 按原因决定修配置还是重试
Section titled “3. 按原因决定修配置还是重试”401/403 修凭据或权限，429 按服务要求等待，临时 5xx 有限重试。业务缺字段可用 Stop And Error 入队列。HTTP 节点、SDK、整个工作流不同时层层重试，给整体等待时间设预算。
4. 分清手动检查与自动失败
Section titled “4. 分清手动检查与自动失败”手动运行检查字段和分支，Error Trigger 通常响应自动执行失败。手动没收到通知不等于绑定无效。用受控自动触发器验证，再去执行历史看原流程与错误流程。
5. 补跑保留链路并防重复
Section titled “5. 补跑保留链路并防重复”先读 item_id 与步骤状态，用唯一键防重复写入。retryOf 和执行 URL 不一定存在，字段允许空。记录原执行、重试执行、处理人、终态；错误 handler 自己失败也要有可查看出口，不删除原记录。
练习样例：下载 workflow-error-register.csv，可在本地练习；非本站实测结果。
可追踪的错误队列和只补跑必要步骤的操作记录。
- 继续执行设置可能让错误不再触发 handler，检查实际分支。
- 错误信息可能带输入或凭据片段，持久前脱敏。
- 受控自动失败可写队列，记录原执行 ID。
- 补跑不会重复已完成动作，历史可查。
来源边界：依据所列公开来源整理；本站未复现演示。分类结果需人工复核，不会自动执行。
- Jev Python 调用失败怎么办：超时、重试和错误状态分开记
- LangGraph 人工审批与恢复：暂停后怎样避免重复执行
- n8n-nodes-typesafe-ai 怎么用：把一个受控判断步骤嵌入已有自动化流程
手动执行为什么没触发 Error Trigger？
Section titled “手动执行为什么没触发 Error Trigger？”错误工作流通常响应自动执行失败；分别检查手动分支与受控自动失败链路。