SuperAPI AI 工具集

n8n-impl-workflow-design

部署与运维

查看项目

更新于 10-26 08:07

技能介绍

该技能用于在设计复杂的 n8n v1.x 工作流时提供模式化参考,核心目标是避免因缺少错误工作流等问题导致静默失败。资料以“快速参考表 + 决策树 + 分节说明”的方式组织,覆盖以下主题。

用途与主要能力:

  1. 子工作流模式:调用其他工作流时始终使用 Execute Workflow 节点,避免跨工作流复制逻辑;说明参数传递方式(调用方发送输入项、子工作流在触发节点接收、返回最终输出)以及 callerPolicy 的取值:workflowsFromSameOwner(默认)、workflowsFromAList、any、none。多用户共享实例时应在生产子工作流上显式设置 callerPolicy。建议在逻辑被两个以上工作流复用、工作流超过 20 个节点、或可隔离独立职责时抽取子工作流。

  2. 错误处理:分三层保护。节点级 continueOnFail 让失败项带着 $json.error 继续向下,并应后接 IF 节点检查错误;retryOnFail 用于瞬时失败(如 API 超时、限流),可配置 maxTries(默认 3)与 waitBetweenTries(默认 1000ms),HTTP Request 调用外部 API 时应使用重试;工作流级用 Error Trigger 建立专用错误工作流,在主工作流设置中指定,可服务多个生产工作流,接收工作流名、执行 ID、错误信息等上下文。Stop And Error 节点用于数据校验失败、违反业务规则或必要外部资源不可用时主动失败并触发错误工作流。还可用 executionTimeout 防止失控执行,全局默认由 EXECUTIONS_TIMEOUT 环境变量控制(默认禁用),上限由 EXECUTIONS_TIMEOUT_MAX 控制(默认 3600 秒)。

  3. 分支模式:IF 节点用于二选一路由,输出 0 为真、输出 1 为假,支持字符串、数字、布尔、日期比较与 and/or 组合;两个以上去向应使用 Switch 节点(规则模式或表达式模式),避免串联多个 IF。每个节点还支持 onError 设置:stopWorkflow(默认)、continueRegularOutput、continueErrorOutput。

  4. 合并模式:Merge 节点支持 Append(拼接)、Combine 下按字段合并(类似 SQL JOIN)、按位置合并、Multiplex(笛卡尔积)、Choose Branch(先完成者胜出)和 SQL Query。不同来源且共享键字段时应使用按字段合并,项目数不同时不要按位置合并。

  5. 循环模式:Loop Over Items 节点(原 Split In Batches)按可配置批量拆分输入,循环体输出接回处理链首节点、处理链末节点接回该节点,Done 输出在所有批次完成后触发。适用于 API 限流、内存密集操作、逐项或逐批调用外部 API,并应设置合理批量大小。

  6. 等待与恢复:Wait 节点支持定时恢复(固定时长或指定日期时间)、Webhook 恢复(生成 $execution.resumeUrl,暂停直到请求命中)和表单恢复($execution.resumeFormUrl)。人工审批场景应使用 Webhook 恢复而非轮询,并应在暂停前把恢复 URL 发给外部系统。

  7. 定时模式:Schedule Trigger 支持间隔、cron 表达式和固定时间;应在工作流设置中正确设置 timezone,并在部署时设置 GENERIC_TIMEZONE。资料还给出常用 cron 示例,如 0 * * * 、0 9 * * 1-5、/15 * * * * 等。

  8. 工作流设置参考:列出 errorWorkflow、executionTimeout、callerPolicy、callerIds、timezone、saveDataErrorExecution、saveDataSuccessExecution、executionOrder 的用途与默认值。

设计原则与限制:节点应描述性命名、复杂逻辑加备注、每个生产工作流设置错误工作流、复用逻辑用子工作流而非复制、工作流不超过 30 个节点、外部 API 调用显式配置重试、激活前用固定数据测试、长运行工作流设置执行超时。资料还指向 methods.md、examples.md、anti-patterns.md 三个参考文件,但正文未展开其具体内容。

适用场景:使用 n8n 搭建需要条件分支、失败通知、可复用子流程、批量调用限流 API、人工审批等待或定时执行的自动化工作流。

限制:资料未提供该技能的安装步骤、收费信息、支持平台或实际效果数据,暂未提供。