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 的逻辑是「到点就开跑」,它不问外部任何系统。节点面板上第一行就是提醒:发布之后才按你设的计划跑;想临时试,回画布点执行工作流。

n8n 定时触发器参数:Trigger Interval 选 Hours,6 小时一次,第 30 分钟触发
Trigger Interval 选 Hours,6 小时一次,第 30 分钟触发。面板上那句英文提示说的是「发布后才按这个计划跑」。

参数是分档的: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。

n8n Webhook 节点参数面板,Webhook URL 停在测试 URL,地址以 webhook-test 开头
测试 URL 是 /webhook-test/ 开头,调试期用这个,点一次监听接一个请求。

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

n8n Webhook 节点切到生产 URL,地址以 webhook 开头,少了 -test
生产 URL 少了 -test 这一段,发布之后才注册,发布之前调它只会 404。

它们不是同一个注册表。工作流没发布时往生产地址发请求,回来的是 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。

n8n RSS Feed Trigger 参数:Poll Times 的 Mode 是 Every Minute
Poll Times 选 Every Minute,就是每分钟问一次源站有没有新条目。

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

没有。第一次跑只输出 1 个项目,下游也是 1 个项目。

n8n 手动跑 RSS 工作流后,触发器与下游节点都只显示 1 个项目
源里 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 抽出去。

怎么确认它真的在跑

别看画布上的绿勾,那只能证明你手动跑的那一次成功了。三个可观察的证据,按可靠程度排。

  1. 执行记录。编辑器顶部「执行」标签,或者 REST 的 /rest/executions?workflowId=...,看 mode 和 startedAt。定时跑出来的 mode 是 trigger,webhook 是 webhook,手点是 manual。列表里出现一条你没点过的 trigger 记录,才算真在跑。
  2. 工作流的 staticData。轮询类会写 lastItemDate 这类游标,定时类会写 recurrenceRules。这比执行记录更早出现,能证明触发器已经注册并被调度过。
  3. 外部可见的副作用。我习惯在末尾加一个带 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 的三种方式。

参考资料

最后更新:2026 年 11 月 18 日,用的是 n8n 2.43.7。

THE END