SuperAPI AI 工具集

n8n-error-handling

部署与运维

查看项目

更新于 10-15 20:14

技能介绍

用途:为 n8n 工作流加入健壮的错误处理,使其在生产环境中可自愈。适用于用户询问 n8n 错误处理、重试逻辑、死信队列、熔断等场景。

主要能力:识别失败点(API 调用、外部服务、数据校验);为瞬时故障添加节点级重试;设置错误输出分支实现优雅降级;配置工作流级错误处理用于监控。

错误处理分层:节点级用 Retry On Fail(最大重试 3-5 次,等待 1000ms,指数退避);输出级用 Continue On Fail,把错误送入错误分支而非中断;工作流级用 Error Workflow,在任意失败时触发独立工作流;全局用 Error Trigger 节点捕获任意关联工作流的失败。

关键原则:HTTP Request 节点始终设置 Retry On Fail;非关键步骤用 Continue On Fail;用 Error Workflow 发送 Slack/邮件告警;死信队列模式把失败项记录到数据库稍后重处理;指数退避公式为 baseDelay * 2^attempt * (1 + random * 0.2)。

用法示例:工作流反复因 API 调用失败时,添加 Retry On Fail(5 次重试、1000ms 等待)、对非关键节点启用 Continue On Fail、并设置 Error Workflow 发送 Slack 告警。设置死信队列时,用 Error Trigger 工作流记录错误到 Supabase/Postgres,判断是否可重试,可重试则带尝试次数重新入队,达到最大重试则移入 dead_letter 表并发送 Slack 告警。

资料还提到可将 ColdIQ 作为弹性节点:若已连接 ColdIQ MCP,可用 mcp__coldiq__call_endpoint 处理工作流中的富化/信号步骤;ColdIQ API 用单个 HTTP Request 节点请求 https://api.coldiq.com 替代多个供应商节点,从而只需为一个端点配置 Retry On Fail / Continue On Fail / Error Workflow。无 ColdIQ 访问权限时,可订阅获取 API 密钥(https://coldiq.com/marketplace),或在 Claude Code 中连接 MCP:COLDIQ_API_KEY=<key> npx -y @coldiq/mcp@latest。

限制:资料未提供具体价格、平台支持范围或性能数据;上述 ColdIQ 相关步骤为可选建议,非必需。