n8n中Wait节点的使用详解:流程暂停与恢复的实战指南
n8n中Wait节点的使用详解:流程暂停与恢复的实战指南
- 一、Wait节点的核心作用
- 二、Wait节点的四大恢复模式
- 1. 时间间隔等待(After Time Interval)
- 2. 指定时间恢复(At Specified Time)
- 3. Webhook回调触发(On Webhook Call)
- 4. 表单提交触发(On Form Submitted)
- 三、关键参数配置详解
- 1. 认证配置(Authentication)
- 2. HTTP方法设置(HTTP Method)
- 3. 响应控制(Respond)
- 4. 等待超时机制(Limit Wait Time)
- 四、使用注意事项
- 五、典型应用场景
- 场景1:API调用限流
- 场景2:用户交互流程
- 场景3:异步任务回调
- 六、高级技巧
- 七、官方模板参考
- 八、常见问题解答
- 九、总结
一、Wait节点的核心作用
在n8n工作流引擎中,Wait节点是实现流程暂停与恢复的关键组件。它允许开发者在工作流执行过程中设置等待状态,待满足特定条件后自动恢复执行,同时保留当前执行数据。这种机制在以下场景中尤为实用:
- API调用限流:通过时间间隔控制请求频率
- 外部事件触发:等待用户反馈、第三方回调等异步操作
- 定时任务调度:实现精确的定时执行逻辑
二、Wait节点的四大恢复模式
n8n的Wait节点支持四种主流的恢复方式,开发者可根据业务需求灵活选择。
1. 时间间隔等待(After Time Interval)
- 配置参数:
- Wait Amount:等待时长(如30)
- Wait Unit:时间单位(秒/分钟/小时/天)
- 适用场景:需要延迟执行的场景,如API请求冷却期
- 注意事项:小于65秒的等待会直接阻塞进程,不会写入数据库
2. 指定时间恢复(At Specified Time)
- 配置方式:通过日期时间选择器设置具体恢复时间
- 时区说明:始终使用n8n服务器时区,与工作流时区设置无关
- 典型应用:定时任务触发器,如凌晨执行数据同步
3. Webhook回调触发(On Webhook Call)
- 核心功能:
- 自动生成唯一恢复URL:$execution.resumeUrl
- 支持多种认证方式:Basic Auth/Header Auth/JWT Auth/None
- 自定义响应码与响应体
- 高级配置项:
- Binary Property:处理二进制数据的字段名
- IP白名单:限制Webhook调用来源
- Raw Body模式:返回原始数据格式
4. 表单提交触发(On Form Submitted)
- 表单配置要素:
- Form Title:表单标题(如"请输入验证码")
- Form Descr