n8n 触发器全解:手动、定时、Webhook、轮询、应用触发器的区别
新建工作流的第一件事不是拖节点,是回答「这东西什么时候开始跑」。n8n 给了五个选项:手动、定时、Webhook、轮询类的应用触发器,还有一堆名字里带 Trigger 的第三方节点。名字排在一起像并列的五个口味,实际上按「谁先动手」只分三类。
选错的代价不是弹个红框,是安静地不干活。我见过最多的两种:定时任务在画布上一片绿,线上一条执行都没有;Webhook 拿测试地址发到正式环境,第一次通了,第二次回来 404。
这篇把五种拆开,讲清各自什么时候触发、数据从哪来、第一次跑会给你什么、怎么确认它真在跑。适合已经能拖节点、发布过至少一条工作流的读者。
这篇不短,按需要跳:
五种触发器,其实是三类
判断一个触发器怎么工作,问三件事就够:谁决定开始跑、你能不能等、数据是对方推过来的还是你自己去拿的。
| 触发器 | 谁动手 | 典型延迟 | 要不要发布 | 第一次跑给你什么 |
|---|---|---|---|---|
| 手动 Manual | 你点执行 | 零 | 不用,也发不出去 | 一条空数据,或者模拟数据 |
| 定时 Schedule | 它自己看表 | 到点为止,秒级 | 要 | 一条空 item |
| Webhook | 外部系统发请求 | 毫秒级 | 要 | 请求里的 headers、query、body |
| 轮询(Poll Times) | 它按间隔去问 | 一个轮询周期 | 要 | 只给最新的那一条 |
| 应用触发器 | 看底子:推还是问 | 推是毫秒,问是周期 | 要 | 看底子 |
最后一行写得含糊,是因为它确实含糊。同一个分类里,Gmail Trigger 是每分钟去问一次,Stripe Trigger 是等 Stripe 发 webhook,Telegram 两种都支持。名字骗人,底子不骗人。
我这台实例的节点库里,group 标着 trigger 的节点名去掉重复之后有 112 个,参数里带 Poll Times 的只有 17 个。剩下的多数走 webhook,少数走长连接订阅,kafka、mqtt、amqp 都是。所以「应用触发器」这个说法只能说明它绑了哪个应用,说明不了事件是怎么进来的。
手动触发:只在你点的时候跑
Manual Trigger 最没有歧义:在编辑器里点「执行工作流」,它跑一次,别的时候永远不动。新建工作流默认塞给你的就是它。
n8n 只允许一个手动触发器。往已经有 Manual Trigger 的工作流里再放一个,界面会拦下来,文档里对应的报错原文是 Only one 'Manual Trigger' node is allowed in a workflow。这个设计我认,手动入口本来就该只有一个。
它的用途是调试,代价是:只有手动触发器的工作流,右上角发布按钮永远是灰的,鼠标放上去提示「此工作流没有需要发布的触发节点」。也就是说它当不了线上入口。要让流程自己跑,换成 Schedule Trigger;要让外部调,换成 Webhook。
调试期的数据是空的,一条 {}。想让下游有字段可读,用节点的「设置模拟数据」,或者在前面挂一个 Edit Fields 写死几个字段。这事看着小,但第一次用表达式取 {{ $json.xxx }} 拿到 undefined,八成就是这里没数据。
定时触发:它自己看表
Schedule Trigger 的逻辑是「到点就开跑」,它不问外部任何系统。节点面板上第一行就是提醒:发布之后才按你设的计划跑;想临时试,回画布点执行工作流。

参数是分档的:Trigger Interval 可以选秒、分、时、天、周、月,或者 Custom (Cron)。秒和分填 1–59,小时 1–23,天 1–31。选周能多选星期几,选月要填几号,文档里有一句值得记住:那个月没有这一天,就不触发。填 30 号,二月直接跳过。
Cron 那档是六段,比 Linux 的 crontab 多一段秒。*/10 * * * * * 是每 10 秒,0 6 * * * 是每天 6 点,秒不填也照跑。
时区是这块最容易翻车的地方。节点用的是工作流时区,没设才用实例时区,自托管默认 America/New_York。我这台实例和工作流都设了 Asia/Shanghai,看到的才是北京时间。你要是只改了容器里的 TZ、没改 GENERIC_TIMEZONE,面板上不会报任何错,执行时间整体偏 13 小时。
还有一条 2.43.7 特有的限制:漏跑补跑的开关在这个版本上不起作用。节点设置里那个 If Execution Is Missed 是 2.36 加的,但它只在 durable 调度器下生效,而 durable 从 2.45.0 才默认打开。2.43.7 走的是内存调度器,机器停两小时,恢复后不会补这两小时。上周我专门停了一次实例,停 45 秒,缺的三次一条没补。
顺手给个实测数字:我建了一条 5 秒一次的定时工作流,跑 16 秒,执行记录的时间戳是 01:34:00.019、01:34:05.026、01:34:10.032。间隔 5.0 秒,而且落在整 5 秒刻度上,不是从发布那一刻起算的。
Webhook:别人来敲门
Webhook 把入口反过来:不是 n8n 去问谁,是别人往这个地址发请求,n8n 收到就开跑。适合对方系统支持回调的场景,GitHub push、支付回调、表单提交都走这个路子。
要填的东西不多:HTTP Method(DELETE、GET、HEAD、PATCH、POST、PUT 六选一)、Path、Authentication、Respond。Path 默认是随机串,可以改成固定值,也支持 /orders/:id 这种带变量的写法。
几个硬限制先摆出来。请求体最大 16MB,自托管可以改 N8N_PAYLOAD_SIZE_MAX。一个 path 加一个 method 只能注册一个 webhook,两条工作流抢同一个地址会失败,原文是 There is a conflict with one of the webhooks.,HTTP 409,hint 里直接点出冲突方的 workflowId。认证默认 None,意思是拿到地址的人都能触发它。
Respond 决定调用方拿到什么。默认 Immediately,立刻回一句话——我在实例上抓到的响应体就是 {"message":"Workflow was started"},不是你的业务数据。想返回数据得改成 When Last Node Finishes,再选 Response Data 是全部条目还是第一条 JSON。第三种是交给 Respond to Webhook 节点自己决定,适合要先校验再回不同状态码的接口。
测试地址和生产地址是两套东西
这是 Webhook 最坑的一处,也是被问得最多的一处。节点面板顶上并排两个标签:测试 URL 和 生产 URL,地址长得很像,只差一段 -test。

切到生产标签,路径里的 webhook-test 就变成 webhook:

它们不是同一个注册表。工作流没发布时往生产地址发请求,回来的是 404,正文写得很直白:
{
"code": 404,
"message": "The requested webhook \"GET demo030-hook\" is not registered.",
"hint": "The workflow must be active for a production URL to run successfully. ..."
}
往测试地址发、但你没在编辑器里点「监听测试事件」,回来的也是 404,同样一句 not registered,hint 换了:Click the 'Execute workflow' button on the canvas, then try again. (In test mode, the webhook only works for one call after you click this button)。
括号里那句话是真的。我点了监听,连发两次请求:第一次 200,拿到节点里拼的那几个字段;第二次 404。测试地址是一次性的,点一次接一个请求,不是窗口期一直开着。文档写监听时长 120 秒,实际能不能接第二个请求,答案是接不了。
所以流程得这么走:调试用测试地址,每发一次请求前先点一次监听;逻辑确认无误,发布工作流,把生产地址交给对方。发布之后生产地址一直有效,直到你取消发布。另外生产地址收到的请求不会在画布上弹数据,只能去执行记录里看,官方 hint 里专门写了这句。
轮询:它自己去看有没有新的
轮询类触发器长得像事件通知,实际干活方式是每隔一段时间去问一次「有新东西吗」。参数里那个 Poll Times 就是节奏:Every Minute、Every Hour、Every Day、Every Week、Every Month、Every X,或者自定义 cron。

我用站点的 RSS 源做了一个,Mode 设 Every Minute,Feed URL 指向自己的订阅源。源里现在有 10 条,我原以为第一次跑会把这 10 条全倒出来。
没有。第一次跑只输出 1 个项目,下游也是 1 个项目。

翻工作流的 staticData,里面只留了一个时间戳:lastItemDate: 2026-11-17T08:12:03Z,正好是源里最新那条的发布时间。它首跑先记了个「我看到这儿了」,然后把最新那条当新的给你。我又新建了一条从没发布、没跑过的工作流试了一次,结果一样,还是 1 条。
这个行为省掉了重复处理,但也意味着:想用轮询触发器把历史数据导一遍,行不通,导入请用普通节点手动跑。
另一个容易误判的点:没有新条目的时候,轮询不产生执行记录。我激活后等了 75 秒,执行列表一条没多,只有 staticData 的时间戳证明它问过了。所以「定时没动静」和「轮询没动静」要分开判断,前者看执行记录,后者先确认它到底有没有在问。
轮询的延迟等于间隔。设 Every Minute,最坏晚 60 秒;设 Every Hour,最坏晚一小时。Gmail Trigger 这类还多一层:Max Emails per Poll 默认 10,最大 50,超出的排队到下一轮。你一分钟进来 30 封,一批只处理 10 封,剩下的要等后面几轮,延迟是叠加的。
应用触发器:名字像事件,底子不一定
n8n 里那一百多个第三方触发器,判断机制只看一处:参数里有没有 Poll Times。有,就是轮询;没有,基本是 webhook 或者长连接。
举几个这版节点库里的原话。Gmail Trigger 的描述是「Fetches emails from Gmail and starts the workflow on specified polling intervals」,摆明是轮询。Stripe Trigger 和 Slack Trigger 写着「Handle ... events via webhooks」,是推送。GitHub Trigger 一个 Poll Times 参数都没有,走的是 webhook 注册。Telegram 两边都沾。
这个区别决定三件事:延迟、成本、还有你要不要给它一个公网地址。webhook 类要求你的 n8n 能被对方访问到;轮询类不需要,但每分钟问一次 Gmail,API 配额和凭据权限都是成本。
我不太喜欢用「应用触发器」这个词做分类,它只说明绑了哪个应用。真要选,先翻到参数面板看一眼有没有 Poll Times,比看名字靠谱。
一条工作流挂两个触发器,行不行
行。我在一条工作流里同时放了 Webhook 和 Schedule Trigger,发布成功,两个入口都验过:curl 打 webhook 回了 200,定时那侧也按 6 小时档登记了规则。
但我不建议这么干。入口多了,出问题时第一件事就是搞不清这次是谁触发的。执行记录的 mode 字段能区分,webhook、trigger、manual 三种我都见过,可节点日志混在一条时间线里,排查成本翻倍。真需要两个入口,我更愿意拆成两条工作流,公共逻辑用 Execute Sub-workflow 抽出去。
怎么确认它真的在跑
别看画布上的绿勾,那只能证明你手动跑的那一次成功了。三个可观察的证据,按可靠程度排。
- 执行记录。编辑器顶部「执行」标签,或者 REST 的
/rest/executions?workflowId=...,看 mode 和 startedAt。定时跑出来的 mode 是trigger,webhook 是webhook,手点是manual。列表里出现一条你没点过的 trigger 记录,才算真在跑。 - 工作流的 staticData。轮询类会写 lastItemDate 这类游标,定时类会写 recurrenceRules。这比执行记录更早出现,能证明触发器已经注册并被调度过。
- 外部可见的副作用。我习惯在末尾加一个带 tag 的 HTTP 请求,打到自己的站点日志里,时间戳一目了然。这条不依赖 n8n 存不存执行记录。
Webhook 还有第四个办法:直接 curl,看返回码和返回体。200 加上你自己的字段,说明整条链路通了,比看界面快。
curl -s -o - -w "\n%{http_code}\n" "https://你的域名/webhook/demo030-hook?t=1"
五个真会遇到的报错
一、The requested webhook … is not registered
两种原因,看 hint 就能分。提「workflow must be active」,是工作流没发布;提「Click the 'Execute workflow' button」,是测试地址没人监听。别去改 Path,路径通常是对的。
二、测试地址第二次就 404
不是偶发。点一次监听只接一个请求,验证完逻辑就该换生产地址。我在这上面浪费过一个下午,一直怀疑是对方系统没发出来。
三、There is a conflict with one of the webhooks
409,path 加 method 撞了。多半是以前调试留下的工作流还在发布状态。把旧的取消发布,或者换个 path。hint 里带着冲突方的 workflowId,照着找很快。
四、定时任务到点没反应
先确认发布状态,再确认时区,这两条占了九成。剩下的看调度器:2.43.7 是内存调度器,进程重启那段时间不补跑,也不会告诉你缺了几次。
五、轮询「什么都没发生」
大概率本来就没有新数据。没有新条目时不产生执行,界面上一点动静都没有。想确认它在问,去看 staticData 的时间戳有没有往前走。
安全:Webhook 的默认状态是「谁都能敲」
Webhook 节点的 Authentication 默认 None。地址一旦泄露,任何人发个 GET 就能让你的工作流跑起来,消耗你的执行次数,也消耗你接在后面的那些凭据。生产地址通常还得暴露在公网,这事不能靠「没人知道我的路径」来兜。
Authentication 里有四种可选:Basic Auth、Header Auth、JWT Auth、n8n User Auth (OAuth2)。大多数场景 Header Auth 就够:约定一个头,值放一段长随机串,对方系统基本都支持自定义 header。用 n8n User Auth 的话,非 GET 请求拿不到 token 直接 401,别指望它跳登录页。
轮询类看起来安全,方向其实相反:它拿着你给的凭据主动去读数据。Gmail 这类触发器读到的是整个邮箱,不只是你关心的那几封。真要用,单开一个账号,或者用 Search 过滤到具体发件人,先把范围收窄。
还有一条容易忽略:webhook 的完整 URL 会出现在执行记录和日志里,截图发出去等于把入口发出去了。写这类文章时我把 path 都换成了 demo 开头的示例值,不是怕,是没必要。
小结
五种触发器,本质是三种:你点、它看表、别人敲门。轮询属于「它自己去看」,只是包装成了事件的样子,延迟藏在间隔里,成本藏在凭据里。
选型先问一句:对方系统能不能回调。能,就 Webhook,记得发布、记得加认证;不能,就轮询,接受一个周期的延迟;跟外部系统无关的,才轮到定时。
发布这一步没有捷径。定时和 Webhook 不上线就永远不跑,测试地址只接一次请求。这两句话能省掉大半的「为什么没反应」。
接着往下:Webhook 通了之后,下一个坑通常在数据形状上,数据在节点之间怎么流动讲得细些。定时任务已经上线却不跑,工作流定时不触发按原因分了五条。上一篇是 Windows 上装 n8n 的三种方式。
参考资料
- n8n Docs:Manual Trigger
- n8n Docs:Schedule Trigger
- n8n Docs:Webhook 与 Common issues
- n8n Docs:RSS Feed Trigger
- n8n Docs:Gmail Trigger
- n8n 中文课程总目录
最后更新:2026 年 11 月 18 日,用的是 n8n 2.43.7。

