用途:让 n8n 工作流的失败显眼、结构化、可恢复。默认节点抛错会中止整个工作流,对无人值守场景(Webhook API、cron、队列 worker、agent 工具)不合适,调用方只会收到超时或空 500,运维方无告警。
主要能力:节点级错误输出(onError: "continueErrorOutput" 创建 main[1],再用 sourceIndex: 1 接到处理器);工作流级错误工作流(Error Trigger 捕获漏网失败);网络节点 retryOnFail 自愈;Webhook 工作流中所有路径都需以 Respond to Webhook 结束,并按原因映射 4xx/5xx 状态码;用 Set 节点做输入校验;用单个表达式驱动的 Respond 计算状态码。
使用方式:用 n8n_update_partial_workflow 设置 onError、retryOnFail(maxTries 上限 5,waitBetweenTries 上限 5000ms),用 addConnection 配 sourceIndex: 1 接错误输出,再用 n8n_get_workflow 验证两半都到位。错误工作流需在 UI 的 Workflow Settings → Error Workflow 手动指定,MCP 无法设置。
限制:表达式内 JS 错误、Python Code 节点被拒或返回形状错误等失败不会走错误输出;错误输出接空操作会视为已处理,错误工作流不触发;错误工作流通知渠道若与监控渠道相同可能递归失败;不得把堆栈、SQL、token 等内部信息泄露到响应中。