用途:为 n8n 工作流设计可见、结构化、可恢复的失败处理,重点覆盖无人值守场景(Webhook/API、cron、队列 worker、agent 工具)以及需要明确响应契约的接口。
主要能力:
- 节点级错误输出:设置 onError: "continueErrorOutput" 创建第二个输出,并用 addConnection 的 sourceIndex: 1 将其接到真实处理器;两步缺一不可,否则错误被静默丢弃或处理器不可达。
- 重试:对网络类节点设置 retryOnFail: true、maxTries: 3、waitBetweenTries: 5000(毫秒),先吸收瞬时故障。引擎限制:任何错误都会触发重试,maxTries 上限 5,waitBetweenTries 上限 5000ms。
- 工作流级错误工作流:以 Error Trigger 节点构建独立工作流,接收 execution、workflow、error 等上下文,用于捕获未接线的失败、节点间崩溃与超时。
- API 响应契约:所有路径(含错误)都必须以 Respond to Webhook 结束;按原因映射状态码(400/401/403/404/409/429/500/502/503/504),并显式设置 responseCode,避免错误分支返回 200。
- 输入校验:可在单个 Set 节点内用 IIFE 做 schema 校验,返回 valid、validationError、details、requiredSchema,再由 IF 分支。
使用方式:通过 MCP 工具 updateNode/patchNodeField 设置 onError 与 retryOnFail,addConnection 接线错误输出,validate_workflow 校验,n8n_get_workflow 复核两半配置,n8n_executions 检查失败。错误工作流的指派(Workflow Settings → Error Workflow)只能在 n8n UI 完成,无对应 MCP 工具。
限制与注意:错误输出半接线不会被 validate_workflow 发现;错误工作流若通知与监控同一通道,通道故障会导致错误丢失,应换通道并加 Data Table 兜底;响应与告警中不得泄露凭据、个人数据、请求体与堆栈,只返回最小诊断信息。
适用场景:无人值守工作流、Webhook/API 响应契约、重试设计、告警与自愈。内部一次性手动运行的工作流可保持默认 stopWorkflow。