n8n Webhook 节点实战教程：从入门到生产级部署

3.3 Webhook URL

n8n 自动生成两个 URL：

一定要用 Production URL 做生产对接。

3.4 Response

Webhook 可选择是否立即响应。

• Respond immediately
  用于低延迟（如微信回调必须 5 秒内响应）
• Respond with data
  返回 JSON 给调用方（常用于 API）

3.5 Webhook Response Body（可表达式）

可以返回动态 JSON：

{ "status": "ok", "received": {{$json}} }

4. Webhook 数据结构（实际接收示例）

Webhook 会接收以下几种数据：

4.1 Query 参数

GET /hook?user=tom&id=55

对应数据：

{ "query": { "user": "tom", "id": "55" } }

4.2 Body（POST JSON）

{ "orderId": 1001, "amount": 88.5 }

Webhook 返回：

{ "body": { "orderId": 1001, "amount": 88.5 } }

4.3 Headers

包括 token、签名等。

5. 完整流程图（直观、清晰）

flowchart TD
A[Webhook - 接收外部请求] --> B[IF 校验签名 / Token]
B -->|通过| C[处理数据：写数据库 / 发送消息 / 调 API]
B -->|失败| D[返回错误响应]
C --> E[Webhook Response - 返回成功 JSON]

6. 测试数据（可直接 POST）

使用 Postman / curl 发送：

POST https://你的域名/webhook/order/create
Content-Type: application/json
{ "orderId": 1001, "user": "Emilie", "amount": 99.9 }

测试返回：

{ "message": "Webhook received", "data": { "orderId": 1001, "user": "Emilie" } }

7. 可导入 Webhook Demo（JSON）

以下 Demo 包含：

• Webhook
• IF 校验 token
• Set Response
• Webhook Response

可直接导入 n8n。

{
  "nodes": [
    {
      "id": "1",
      "name": "Webhook Entry",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [300, 300],
      "parameters": {
        "httpMethod": "POST",
        "path": "order/create",
        "respond": true
      }
    },
    {
      "id": "2",
      "name": "IF Token",
      "type": "n8n-nodes-base.if",
      "typeVersion": 1,
      "position": [550, 300],
      "parameters": {
        "conditions": {
          "string": [
            {
              "value1": "={{$json[\"headers\"][\"x-token\"]}}",
              "operation": "equal",
              "value2": "123456"
            }
          ]
        }
      }
    },
    {
      "id": "3",
      "name": "Set Response Success",
      "type": "n8n-nodes-base.set",
      "typeVersion": 2,
      "position": [800, 250],
      "parameters": {
        "values": {
          "json": [
            {
              "name": "message",
              "value": "Webhook received"
            },
            {
              "name": "orderId",
              "value": "={{$json[\"body\"][\"orderId\"]}}"
            }
          ]
        }
      }
    },
    {
      "id": "4",
      "name": "Webhook Response",
      "type": "n8n-nodes-base.respondToWebhook",
      "typeVersion": 1,
      "position": [1050, 250],
      "parameters": {
        "responseBody": "={{$json}}"
      }
    }
  ],
  "connections": {
    "Webhook Entry": {
      "main": [[{"node": "IF Token", "type": "main", "index": 0}]]
    },
    "IF Token": {
      "main": [
        [{"node": "Set Response Success", "type": "main", "index": 0}],
        []
      ]
    },
    "Set Response Success": {
      "main": [[{"node": "Webhook Response", "type": "main", "index": 0}]]
    }
  }
}

8. 最佳实践（生产环境建议）

✔ 1. 所有 Webhook 必须加 Token 或签名校验

防止被随便 POST。

✔ 2. 使用 Production URL，不要用 Test URL

Test URL 在关闭编辑器后就失效。

✔ 3. 响应必须尽快返回，不要让第三方超时

可用 Respond Immediately → 后台处理。

✔ 4. 对接支付、验证类 Webhook 强制校验签名

如微信支付、Stripe。

✔ 5. Webhook + Queue + Split In Batches 处理大并发

避免 n8n 一次处理 1000 条订单导致崩溃。

9. 常见踩坑点（真实遇到过）

❌ 坑 1：Webhook 收不到数据？

原因：用了 Test URL，但 workflow 没保持'打开编辑器'状态。

❌ 坑 2：Webhook 响应超时

不要在 Webhook 节点后做复杂流程。
改用：

✔ Respond immediately
✔ 后面再做逻辑

❌ 坑 3：Headers 取不到？

由于大小写问题，应该用：

$json["headers"]["x-token"]