n8n中Wait节点的使用详解:流程暂停与恢复的实战指南
一、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