n8n 中文文档

HTTP请求节点常见问题

以下是 HTTP 请求节点 的一些常见错误和问题以及解决这些问题的步骤。

错误请求 - 请检查您的参数

当节点收到表示错误请求的 400 错误时显示此错误。此错误最常发生的原因是:

请查看您服务的 API 文档以格式化您的查询参数。

找不到您请求的资源

当您输入的端点 URL 无效时显示此错误。

这可能是由于 URL 中的拼写错误或已弃用的 API 造成的。请参考您服务的 API 文档以验证您拥有有效的端点。

连接被拒绝 (ECONNREFUSED)

当节点能够访问网络上的主机,但目标端口没有服务监听时,会显示此错误。TCP 连接被主动拒绝。这不是 DNS 失败、超时或防火墙丢包。

在自托管 n8n 中,最常见原因是 Docker 网络。在 n8n 容器内,localhost 和 127.0.0.1 指向容器本身,而不是宿主机。从节点请求 http://localhost:5000 会落到 n8n 容器的 5000 端口,而该端口没有服务监听。

要解决此问题,请使用容器可路由到的名称访问目标:

  • 目标在宿主机上,Docker Desktop(Mac 或 Windows):在 URL 字段中使用 http://host.docker.internal:<port>。Docker Desktop 会自动添加此主机名。
  • 目标在宿主机上,Linux:向容器传递 --add-host=host.docker.internal:host-gateway,或在 docker-compose.yml 中设置 extra_hosts: yaml services: n8n: image: n8nio/n8n extra_hosts: - "host.docker.internal:host-gateway" MySQL 节点 记录了相同的修复。
  • Target in another container on the same Compose stack 目标位于同一 Compose 堆栈上的另一个容器中:使用服务名称作为主机名,例如http://my-api:5000。引用容器的内部端口,而不是发布的 ports: 映射。

另一个单独原因会出现在 Node.js 17 及更高版本中,即使不使用 Docker 也可能发生:localhost 会先解析到 IPv6 地址 ::1,然后才是 127.0.0.1。如果目标只绑定到 127.0.0.1,IPv6 尝试会被拒绝,而 HTTP Request 节点内回退到 IPv4 并不总是成功。

在 URL 字段中使用 http://127.0.0.1:<port>,而不是 localhost。

在重新运行工作流前,要验证修复是否生效,请进入 n8n 容器并使用 wget 尝试访问该 URL:

docker exec -it n8n wget -qO- http://host.docker.internal:5000/health

如果从容器内运行 wget 成功,HTTP Request 节点也会成功。如果 wget 也返回 "connection refused",原因在网络或目标服务,而不是 n8n。

在 n8n Cloud 上,工作流运行在 n8n 的基础设施中。那里没有指向你本机的 localhost,也无法直接访问你机器上的服务。请通过 tunnel 暴露仅本地可访问的目标,并在 HTTP Request 节点中使用公共 URL。

JSON 参数需要是有效的 JSON

当您将参数作为 JSON 传递但格式不是有效 JSON 时显示此错误。

要解决此问题,请检查您输入的 JSON 是否存在这些问题:

  • 在 JSON 检查器或语法解析器中测试您的 JSON,以查找缺少引号、多余或缺少逗号、格式不正确的数组、多余或缺少方括号或大括号等错误。
  • 如果您在节点中使用了 Expression 表达式,请确保您已将整个 JSON 包装在双大括号中,例如: {{ { "myjson": { "name1": "value1", "name2": "value2", "array1": ["value1","value2"] } } }}

禁止 - 也许检查您的凭据

当节点收到表示身份验证失败的 403 错误时显示此错误。

要解决此问题,请检查所选凭据并确保您可以使用它们进行身份验证。您可能需要:

  • 更新权限或范围,以便您的 API 密钥或帐户可以执行您选择的操作。
  • 以不同方式格式化您的通用凭据。
  • 使用适当的权限或范围生成新的 API 密钥或令牌。

429 - 该服务收到了太多来自您的请求

当节点从您调用的服务接收到 429 错误 时,会显示此错误。这通常意味着您已达到该服务的速率限制。您可以在处理 API 速率限制 页面上了解更多信息。

要解决该错误,您可以使用 HTTP 请求节点的内置选项之一:

批处理

使用此选项批量发送请求并在它们之间引入延迟。

  1. 在 HTTP Request HTTP请求节点中,选择 Add Option 添加选项 > Batching 批处理。
  2. 将 Items per Batch 每批项目数 设置为每批处理的输入项数。每个输入项都会生成一个单独的 HTTP 请求。
  3. 将 Batch Interval (ms) 批处理间隔(毫秒) 设置为在请求之间引入延迟(毫秒)。例如,要每秒向 API 发送一个请求,请将 Batch Interval (ms) 批处理间隔(毫秒) 设置为 1000。

失败重试

使用此选项在失败尝试后重试节点。

  1. 在 HTTP Request HTTP请求节点中,转到 Settings 设置 并启用 Retry on Fail 失败时重试。
  2. 将 Max Tries 最大尝试次数 设置为 n8n 应重试节点的最大次数。
  3. 将 Wait Between Tries (ms) 尝试之间的等待时间(毫秒) 设置为重试之间所需的延迟(毫秒)。例如,要在再次重试请求之前等待一秒钟,请将 Wait Between Tries (ms) 尝试之间的等待时间(毫秒) 设置为 1000。

上传文件的文件名错误

将 Body Content Type 正文内容类型 设为 Form-Data 并发送文件时,n8n 会从二进制数据中读取 multipart/form-data 部分的文件名,而不是从 Name 名称 字段读取。Name 名称 只设置表单字段名称。如果二进制数据没有文件名,n8n 会发送 file。

如果接收方 API 按文件名而非表单字段名称识别上传内容,或要求特定名称或扩展名,这一点尤其重要。请求虽然已送达,但 API 会拒绝它,并通常返回 400 错误,提示文件缺失。例如,Convert to File 节点的 Convert to Text File 转换为文本文件 操作默认将输出命名为 file.txt,因此预期 index.html 的 API 无法找到该文件。

要解决此问题,请在 HTTP Request 节点之前为二进制数据设置文件名:

  • 在 Convert to File 节点中,将 File Name 文件名 选项设为 API 预期的名称。
  • 在 Code 节点中,为二进制属性设置文件名:
for (const item of $input.all()) {
    item.binary.data.fileName = 'index.html';
}
return $input.all();

n8n 会将二进制数据中存储的 MIME type 复制到该部分的 Content-Type 中,因此如果 API 会检查它,也请一并设置。

发送文件时出现不支持的媒体类型 (415)

当 API 预期 multipart/form-data,但请求正文不是 multipart 时,会显示此错误。

Body Content Type 正文内容类型 > n8n Binary File n8n 二进制文件 会将文件作为整个请求正文发送。n8n 会把 Content-Type 设为二进制数据中存储的 MIME type;若没有 MIME type,则设为 application/octet-stream,且不会添加 multipart 封装或 boundary。只接受 multipart 上传的 API 会拒绝此请求。

要以 multipart 上传方式发送同一文件:

  1. 将 Body Content Type 正文内容类型 设为 Form-Data。
  2. 添加一个 Body Parameters 正文参数 条目,并将其 Type 类型 设为 n8n Binary File n8n 二进制文件。
  3. 将 Name 名称 设为 API 文档中指定的表单字段名称。
  4. 将 Input Data Field Name 输入数据字段名称 设为保存文件的二进制属性,例如 data。
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。