n8n 中 Webhook 节点的使用方法，包括其作为自动化触发器的原理、应用场景及核心概念。内容涵盖测试 URL 与正式 URL 的区别、支持的 HTTP 方法、响应模式以及数据访问方式。通过实战案例展示了如何构建表单提交自动保存系统，并提供了解决常见问题的方案，如 IP 白名单配置和负载限制调整。文章强调了生产环境下的安全措施，如认证和 HTTPS 的使用，帮助开发者高效利用 Webhook 实现外部服务与 n8n 的实时通信。
Webhook 是一个能让外部服务与 n8n 进行实时通信的工具。简单来说，当某个事件发生时，外部服务会立即将数据推送到你的 n8n 工作流，触发自动化流程。
相比传统的"轮询"方式（不断询问是否有新数据），Webhook 更高效、更实时。一旦事件发生，数据就被立即发送给 n8n，n8n 立刻开始处理。
n8n 为每个 Webhook 节点自动生成两个不同的 URL：
| 类型 | 用途 | 特点 |
|---|---|---|
| 测试 URL（Test URL） | 开发和测试时使用 | 临时有效（120 秒），数据在编辑器中可见，便于调试 |
| 正式 URL（Production URL） | 部署到生产环境 | 工作流激活后永久有效，数据不在编辑器显示，需查看执行日志 |
重要提示：
Webhook 支持所有标准 HTTP 方法：
大多数应用场景下，选择 POST 就够了。
Webhook 节点有三种响应方式：
| 响应模式 | 说明 |
|---|---|
| 立即响应（Immediately） | 立即返回'Workflow got started'消息，工作流继续后台处理 |
| 最后节点完成时响应（When Last Node Finishes） | 等待整个工作流完成，返回最后一个节点的输出 |
| 使用 Respond to Webhook 节点 | 完全控制响应内容、状态码和请求头 |
在 Webhook 节点的设置面板中：
HTTP 方法：POST（根据你的需求选择）
路径：例如 /webhook/process-form
认证方式：None（开发时），生产环境建议用 Basic Auth、Header Auth 或 JWT
获取你的 Webhook URL：
curl -X POST 'https://your-n8n.url/webhook/process-form' \
-H 'Content-Type: application/json' \
-d '{"name":"张三","email":"[email protected]"}'
在 Webhook 节点后面添加其他节点来处理接收到的数据：
当 Webhook 接收请求时，n8n 会将数据解析成 JSON 对象，包含以下部分：
| 数据来源 | 表达式 | 例子 |
|---|---|---|
| 查询参数（?key=value） | {{ $json.query.key }} | {{ $json.query.user_id }} |
| 请求头（Headers） | {{ $json.headers['header-name'] }} | {{ $json.headers['content-type'] }} |
| URL 路径参数（/:id） | {{ $json.params.id }} | {{ $json.params.user_id }} |
| 请求体（Body） | {{ $json.body }} 或 {{ $json.body.field }} | {{ $json.body.customer_name }} |
JavaScript 不支持对象属性名中的连字符。访问含有连字符的请求头时，需要用方括号表示法：
// ❌ 错误
{{ $json.headers.user-agent }}
// ✅ 正确
{{ $json.headers['user-agent'] }}
当请求的 Content-Type 为 application/json 时，n8n 会自动解析为 JSON 对象：
{"body":{"customer":{"name":"Jane Doe","email":"[email protected]"},"order":{"items":[{"name":"T 恤","qty":2},{"name":"杯子","qty":1}]}}}
访问嵌套数据：
{{ $json.body.customer.name }} // 获取客户名字
{{ $json.body.order.items[0].name }} // 获取第一个商品名称
从 HTML 表单提交来的数据会自动解析到 body 中：
{"body":{"customer_email":"[email protected]","customer_name":"李四","product_id":"prod_12345"}}
使用 Set 节点提取数据：
{{ $json.body.customer_email }}
| 认证类型 | 用途 | 安全性 |
|---|---|---|
| None | 内部工具、本地开发 | ⚠️ 无保护 |
| Basic Auth | 信任的服务商 | ✅ 基础保护 |
| Header Auth | 自定义 API 密钥 | ✅✅ 中等保护 |
| JWT Auth | 移动应用、公开 API | ✅✅✅ 高级保护 |
这个工作流接收表单数据，验证后保存到数据库，最后向用户发送确认邮件。
工作流流程：
工作流 JSON 代码（复制到 n8n 导入）：
{"nodes":[{"parameters":{"path":"form-submit","httpMethod":"POST"},"name":"Webhook","type":"n8n-nodes-base.webhook","typeVersion":1,"position":[250,300]},{"parameters":{"values":{"string":[{"name":"email","value":"={{ $json.body.email }}"},{"name":
如何使用这个工作流：
action 属性中填入这个 URL测试请求（使用 curl）：
curl -X POST 'https://your-n8n-instance/webhook/form-submit' \
-H 'Content-Type: application/json' \
-d '{ "name": "王五", "email": "[email protected]", "message": "这是一条测试消息" }'
预期响应：
{"success":true,"message":"Form submitted successfully","timestamp":"2024-12-02T15:30:00Z"}
原因：使用了测试 URL 而不是正式 URL
解决：
解决步骤：
原因：n8n 可能运行在反向代理后面
解决：
设置环境变量：
N8N_PROXY_HOPS=1
如果有多个反向代理，将 1 改为相应数字。
解决：
data）答：默认限制为 16MB
如果是自托管 n8n，可以通过环境变量调整：
N8N_PAYLOAD_SIZE_MAX=300mb
错误信息：'The path and method you chose are already in use'
原因：n8n 不允许注册相同路径和方法的多个 webhook
解决：
当工作流可能超过 100 秒时（n8n Cloud 的超时限制），可以采用异步轮询模式：
jobId$json.body、$json.query 等）来访问数据
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online