n8n 中文文档

常见问题

以下是 Webhook 节点 的一些常见问题和疑问以及建议的解决方案。

监听多个HTTP方法

默认情况下,Webhook 网络钩子节点接受使用单一方法的调用。例如,它可以接受 GET 获取或 POST 发送请求,但不能同时接受两者。如果您想接受使用多种方法的调用:

  1. 打开节点Settings 设置。
  2. 打开Allow Multiple HTTP Methods 允许多种 HTTP 方法。
  3. 返回Parameters 参数。默认情况下,节点现在接受 GET 和 POST 调用。您可以在 HTTP Methods HTTP 方法 字段中添加其他方法。

Webhook 网络钩子节点为每个方法都有一个输出,因此您可以根据方法执行不同的操作。

使用HTTP Request节点触发Webhook节点

HTTP Request 节点向您指定的 URL 发出 HTTP 请求。

  1. 创建一个新工作流。
  2. 将 HTTP Request HTTP请求节点添加到工作流中。
  3. 从 Request Method 请求方法 下拉列表中选择一个方法。例如,如果您在 Webhook 网络钩子节点中选择 GET 获取作为 HTTP method HTTP方法,则在 HTTP Request HTTP请求节点中选择 GET 获取作为请求方法。
  4. 从 Webhook 网络钩子节点复制 URL,并将其粘贴到 HTTP Request HTTP请求节点的 URL 字段中。
  5. 如果为网络钩子节点使用测试 URL:执行包含 Webhook 网络钩子节点的工作流。
  6. 执行 HTTP Request HTTP请求节点。

使用curl触发Webhook节点

您可以使用 curl 发出触发 Webhook 节点的 HTTP 请求。

提示

在示例中,将 <https://your-n8n.url/webhook/path> 替换为您的 Webhook URL。\ 这些示例发出 GET 请求。您可以使用在 HTTP Method HTTP方法 中设置的任何 HTTP 方法。

发出不带任何参数的 HTTP 请求:

curl --request GET <https://your-n8n.url/webhook/path>

发出带有正文参数的 HTTP 请求:

curl --request POST <https://your-n8n.url/webhook/path> --data 'key=value'

发出带有头部参数的 HTTP 请求:

curl --request GET <https://your-n8n.url/webhook/path> --header 'key=value'

发出发送文件的 HTTP 请求:

curl --request POST <https://your-n8n.url/webhook/path> --form 'key=@/path/to/file'

将 /path/to/file 替换为您要发送的文件的路径。

发送字符串类型的响应

默认情况下,响应格式是 JSON 或数组。要发送字符串类型的响应:

  1. 选择 Response Mode 响应模式 > When Last Node Finishes 当最后一个节点完成时。
  2. 选择 Response Data 响应数据 > First Entry JSON 第一个条目 JSON。
  3. 选择 Add Option 添加选项 > Property Name 物业名称。
  4. 输入包含响应的属性的名称。默认为 data。
  5. 将 编辑字段节点 连接到 Webhook 节点。
  6. 在编辑字段节点中,选择 Add Value 增值 > String 字符串。
  7. 在 Name 名称 字段中输入属性名称。该名称应与步骤 4 中的属性名称匹配。
  8. 在 Value 价值 字段中输入字符串值。
  9. 将 Keep Only Set 仅保留设置 切换为打开(绿色)。

当您调用 Webhook 网络钩子时,它会从 Edit Fields 编辑字段节点发送字符串响应。

测试 URL 与生产 URL

n8n 为每个 Webhook 网络钩子节点生成两个 Webhook URLs 网络钩子URL:Test URL 测试URL 和 Production URL 生产URL。

在构建或测试工作流时,使用 Test URL 测试URL。一旦您准备在生产中使用您的 Webhook URL,请使用 Production URL 生产URL。

URL type 网址类型 How to trigger 如何触发 Listening duration 聆听时长 Data shown in editor UI? 数据显示在编辑器 UI 中?
测试网址 选择 Listen for test event 监听测试事件 并从源触发测试事件。 120 秒 ✅
制作网址 发布工作流程 直到工作流程取消发布 ❌

更多信息请参考工作流开发。

白名单中的IP地址无法连接

如果您无法从 IP 白名单中的 IP 地址连接,请检查您是否在反向代理后面运行 n8n。

如果是这样,请将 N8N_PROXY_HOPS 环境变量 设置为后面运行的反向代理 n8n 的数量。

每个路径和方法只有一个 Webhook

n8n 只允许为每个路径和 HTTP 方法组合注册一个 webhook(例如,对 /my-request 的 GET 请求)。这避免了哪个 webhook 应该接收请求的歧义。

如果您收到消息说您选择的路径和方法已在使用中,您可以:

  • 取消发布包含冲突 Webhook 的工作流。
  • 更改其中一个冲突 Webhook 的路径和/或方法。

n8n 云 超时

n8n Cloud 使用 Cloudflare 来防护恶意流量。如果您的 webhook 在 100 秒内没有响应,传入的请求将失败并返回 524 状态码。

因此,对于可能超过此限制的长时间运行的流程,您可能需要通过配置两个单独的 webhook 来引入轮询逻辑:

  • 一个 webhook 用于启动长时间运行的进程并立即发送响应。
  • 第二个 Webhook,您可以定期调用它来查询进程的状态并在完成后检索结果。
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。