流程自动化 563 仓库 Star
n8n Error Handling
让自动任务失败时有迹可查
本项为 n8n 工作流安排错误处理。它检查可能失败的节点、接口响应和整体错误工作流,区分输入错误、外部服务异常与本地故障,设置合适的重试与通知。适合接口、定时同步和无人值守任务,避免流程停止后无法找到失败位置和原因。
你需要准备:现有 n8n 流程、失败日志、接口约定和通知方式
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
n8n Error Handling 能帮你做什么?
接通失败分支与响应
为可能出错的步骤安排错误输出,确保接口调用者得到与原因相符的状态和有用信息。
处理短暂服务故障
根据节点能力安排有限次数的重试和等待,检查真正失败时怎样记录、返回或通知。
设置流程级补充处理
用整体错误工作流接住未处理的失败,保留任务、节点和时间等定位信息,供后续排查。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
外部接口临时超时
例如先安排有限重试,持续失败时返回明确错误并记录上下文,便于判断是否需要人工处理。
夜间同步无人值守
例如为关键节点和整体流程设置错误处理,测试告警能否到达指定渠道及失败记录是否足够。
怎么开始使用?
你提供的材料
准备这些材料流程错误处理
现有 n8n 流程、失败日志、接口约定和通知方式
处理流程示意
- 01
梳理可能失败的环节
- 02
配置重试响应与告警
- 03
用可控失败验证流程
准备什么,会得到什么?
- 准备的材料
- 现有 n8n 流程、失败日志、接口约定和通知方式
- 交付的结果
- 失败路径、响应格式、重试和流程级错误处理配置。
- 可控失败测试记录,以及日志、告警与待修复事项说明。
使用前要知道
需要已连接的 n8n 实例、MCP、OAuth 及通知渠道权限。部分错误设置接口要求 n8n 2.29+;重试与错误分支必须测试,配置存在不能证明通知已成功送达。
常见问题
接口返回 200 为什么仍可能失败?
200 表示调用方通常会把请求当作成功。若错误路径仍返回它,真实失败可能被隐藏,应按输入、权限或服务故障设置相符状态和说明。
加上重试就不会再丢任务了吗?
重试适合部分短暂故障,不能保证修复错误输入或长期故障。还需要明确失败后的记录、响应和通知,并核对实际执行结果。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- n8n-error-handling-official · SKILL.md ↗2026-10-31 核对
- n8n 官方 Skills · 连接与安装说明 ↗2026-10-31 核对
来源与使用条件
- 原始项目
- n8n-io/skills ↗
- Skill 名称
n8n-error-handling-official- Skill 目录
skills/n8n-error-handling-official- 仓库 Star
- 563 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- Apache-2.0
- 使用条件
- 需要可访问的 n8n 实例、instance-level MCP、Codex OAuth 连接及服务凭证。错误工作流和设置接口依实际版本核对;应有可控测试环境与可用通知渠道,并保留完整插件依赖。
- 注意事项
- n8n 团队官方 Skill,README 明确 Codex 支持。插件提醒不能替代运行测试,错误分支和重试需验证;本站未实测。
查看安装与使用提示词
请帮我准备并使用 n8n Error Handling Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/n8n-io/skills 所选目录:skills/n8n-error-handling-official 参考分支:main 原始目录 frontmatter name:n8n-error-handling-official 安装后的目标调用名:n8n-error-handling-official 来源页面:https://github.com/n8n-io/skills/tree/main/skills/n8n-error-handling-official 安装路线核对日期:2026-11-01 n8n-error-handling-official:当前源 SKILL.md:https://github.com/n8n-io/skills/blob/main/skills/n8n-error-handling-official/SKILL.md n8n-io/skills:当前安装说明:https://github.com/n8n-io/skills/blob/main/README.md n8n:当前 Codex 插件清单:https://github.com/n8n-io/skills/blob/main/.codex-plugin/plugin.json 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。 所选 Skill 的具体安装步骤: 1. 检查 Codex >=0.142.0(当前上游要求 root-plugin marketplace 支持),并识别是否已有 n8n-skills 插件/同名散装目录;避免重复安装。 2. 按当前 README 运行 codex plugin marketplace add n8n-io/skills,然后 codex plugin add n8n-skills@n8n-io,保留整个插件、using-n8n-skills-official 元协议与全部引用资料。 3. 按上游说明重新加载 Codex,在宿主原生界面审阅并信任实际 SessionStart、PreToolUse、PostToolUse Hooks;不把文档复制当成这些 Hooks 已安装。 4. 需要实际操作实例时,先确认用户自有 n8n >=2.2.0,并在 Settings → Instance-level MCP 启用;具体功能还需核对下面列出的版本条件。 5. 需要使用 setWorkflowSettings.errorWorkflow 时,实例必须为 n8n 2.29+,目标错误工作流须已发布并有有效 Error Trigger;只填一个工作流 ID 不等于错误处理已生效。 6. Codex 不会替插件自动配置 MCP。后续获准连接时用 codex mcp add n8n-mcp --url <用户实际实例的 HTTPS 地址>/mcp-server/http,或 GUI Settings → MCP servers → Add server → Streamable HTTP 添加真实 URL;配置后按要求重载。不要提交示例占位域名。 7. OAuth 在首次使用或 Authenticate 中由用户完成;安装验收不连接实例、不登录,也不读取凭据。未认证时只报告插件已具备指南、实例操作尚未就绪。 必须保留的资源: - 完整 n8n-skills 插件(.codex-plugin/plugin.json、hooks/、skills/) - skills/using-n8n-skills-official/ 元协议与 n8n-expressions-official、n8n-node-configuration-official 等被引用 Skills - skills/n8n-error-handling-official/(完整目录) - skills/n8n-error-handling-official/references/API_WORKFLOWS.md - skills/n8n-error-handling-official/references/ERROR_WORKFLOWS.md - skills/n8n-error-handling-official/references/NODE_ERROR_OUTPUTS.md - skills/n8n-error-handling-official/references/RESPONSE_SHAPES.md - skills/n8n-error-handling-official/references/examples/(含 validation-subworkflow.ts 与 validation-subworkflow-usage.ts) 已知依赖:需要可访问的 n8n 实例、instance-level MCP、Codex OAuth 连接及服务凭证。错误工作流和设置接口依实际版本核对;应有可控测试环境与可用通知渠道,并保留完整插件依赖。 原项目许可:Apache-2.0 特别条件:n8n 团队官方 Skill,README 明确 Codex 支持。插件提醒不能替代运行测试,错误分支和重试需验证;本站未实测。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 本地核对插件来源、Skill、using-n8n-skills-official 与 hooks 配置可读、引用文件存在;仅检查当前已知 Codex/n8n 版本和已有连接状态。 2. 安装验收不创建工作流/表、不发 HTTP 请求、不发布或启动执行。未来已获准连接后优先只读列举目标元数据,分清连接/认证失败与 Skill 文件缺失。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $n8n-error-handling-official;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 提供触发方式、用户可见失败约定、重试规则和现有错误通知渠道,先分别设计 API 响应、节点错误分支与后台错误工作流。 - 实际配置前检查实例版本、节点能力与目标是否已发布;用可控样例在授权环境验证,记录哪些失败被处理,不能为了验收直接向真实用户发告警。 我想完成的任务: 检查我的 n8n 流程在超时、接口失败和异常数据时的行为。为关键节点设置明确的错误响应、有限重试和通知,并说明哪些操作不能重复执行;用可控失败样例验证,不直接改动生产任务。 需要我提供的材料: 现有 n8n 流程、失败日志、接口约定和通知方式 期望得到: 错误处理与告警方案、流程配置,以及失败样例的实际验证记录。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。