HTTP Request node fires per-item requests concurrently

当 HTTP Request 节点(typeVersion 4.2)设置为对输入数组逐项执行,且使用 Header Auth 类凭据时,节点会把所有逐项请求同时发出(并发调度),并未逐项串行;如果目标接口对并发鉴权请求敏感,就会在随机条目上返回间歇性 401。优先排查节点的 Batching 设置是

快速结论:当 HTTP Request 节点(typeVersion 4.2)设置为对输入数组逐项执行,且使用 Header Auth 类凭据时,节点会把所有逐项请求同时发出(并发调度),并未逐项串行;如果目标接口对并发鉴权请求敏感,就会在随机条目上返回间歇性 401。优先排查节点的 Batching 设置是否真正生效。

适用环境:工具为 n8n,节点为 HTTP Request(typeVersion 4.2),代码分析基于 tag n8n@2.21.3(Issue 说明其与 n8n@2.20.9 此文件无差异)。Issue 未提供操作系统、Python、CUDA、显卡等环境信息。

最快修复方案:Issue 作者已验证可用的规避方式:在节点 Options → Batching 中设置 Items per Batch = 1、Batch Interval (ms) = 200,使逐项请求之间产生间隔。

注意事项:这不是官方修复,节点本身仍会并发起请求,只是依靠 Batching 间隔降低了并发冲突概率;该设置会增加整体执行耗时。Issue 中提出的“逐项串行模式”与“修正 batchSize 取模判断”只是建议方案,未被合并验证。该 Issue 最终因长期无活动被关闭。

问题场景

在 n8n 中使用 HTTP Request 节点,对上游节点输出的数组逐项执行请求(Execute Once 关闭),配置为 Authentication = Generic Credential Type、Generic Auth Type = Header Auth,URL 使用表达式引用每个 item 的路径。当输入少于 50 个 item 且没有添加 Batching 时,节点会立即启动全部请求并并发执行,对并发鉴权敏感的接口会出现随机 item 上的 401。Issue 作者的对照实验显示:同样的请求用 curl 顺序发送全部成功,而节点并发发送时会在不同索引上间歇失败。

报错原文

HTTP Request node fires per-item requests concurrently

实际表现为接口返回间歇性 HTTP 401,Issue 中未给出完整的错误堆栈文本。

原因分析

根据 Issue 中的代码分析,packages/nodes-base/nodes/HttpRequest/V3/HttpRequestV3.node.ts 在遍历 item 时逐个立即发起请求并推入 promises 数组,最后用 Promise.allSettled 一起等待,因此所有逐项请求本质上是并发的。

唯一的限速逻辑位于 batching 判断处:只有 itemIndex % batchSize === 0 时才 sleep。未配置 Batching 时 batchInterval 为空,限速完全失效;配置 Batching 后默认 Items per Batch 为 50、Batch Interval 为 1000 ms,少于 50 个 item 的运行不会命中取模条件,等于没有任何间隔。

因此 401 的更可能原因不在凭据、URL 或接口限流,而在于并发派发本身触发了接口的鉴权并发限制。以上代码结论来自 Issue 正文的静态分析,未经官方确认。

环境排查

  • 确认 HTTP Request 节点的 typeVersion 是否为 4.2,以及 Authentication / Generic Auth Type 是否配置为 Header Auth。
  • 确认 Execute Once 是否关闭、URL 是否为逐项表达式(如 =https://api.example.com{{ $json }})。
  • 确认 Options 中是否添加了 Batching,以及 Items per Batch、Batch Interval 的实际取值。
  • 确认输入 item 数量:少于 Items per Batch 时,原有取模限速逻辑不会触发。
  • 用 curl 顺序发送相同请求做对照,若顺序请求稳定返回 200,可进一步指向并发派发问题。

解决步骤

  1. 在 HTTP Request 节点中打开 Options → Batching。
  2. 将 Items per Batch 设为 1,将 Batch Interval (ms) 设为 200(这是 Issue 作者手动验证可用的组合,可按接口容忍度调整间隔)。
  3. 重新运行工作流,观察是否仍有 401。
  4. 如需彻底消除并发,可关注 Issue 中建议的“逐项串行模式”是否在后续版本提供;在官方实现前,只能依赖上述 Batching 规避。
  5. 若问题在调整后仍然复现,检查是否还有其他节点或分支同时向同一接口发起请求。

验证方法

用同样 10 条逐项请求的数据重新执行工作流,多次运行后确认不再出现随机索引上的 401,且每条请求均返回预期状态码 200;同时可对比执行耗时,确认间隔按预期生效。若更换批次与间隔后 401 仍间歇出现,说明并发并非唯一诱因,需重新按顺序请求与并发请求做对照。

参考来源

n8n-io/n8n #30652

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36147

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注