OpenAI Chat Model node does not retry 429 Rate Limit errors

该问题通常出现在 AI Agent 节点挂载 OpenAI Chat Model 节点并触发 429 限流时——即便"Retry on fail"已勾选,"OpenAI Chat Model"节点仍不会按设置重试。优先排查 n8n 版本及所接第三方模型服务(如 Cerebras API)的限流行为。

快速结论:该问题通常出现在 AI Agent 节点挂载 OpenAI Chat Model 节点并触发 429 限流时——即便”Retry on fail”已勾选,”OpenAI Chat Model”节点仍不会按设置重试。优先排查 n8n 版本及所接第三方模型服务(如 Cerebras API)的限流行为。

适用环境:n8n 2.4.4,Docker 自托管(Docker Desktop for macOS 26.2,macOS 26.2),Node.js 22.21.1,SQLite 数据库,常规执行模式,企业版许可证;模型服务使用 Cerebras API。

最快修复方案:升级到 n8n 2.15.0 或更高版本,该问题已在 #27364 中修复。

注意事项:修复前的版本(含 2.4.4)节点不会对 429 生效重试设置,只能依赖上游服务限流恢复;升级后仍需确认第三方服务(Cerebras)的 429 是否被正确识别为可重试错误。

问题场景

用户创建 AI Agent 节点并挂载 OpenAI Chat Model 节点后执行工作流。为触发失败,附加了会强制节点高频发起请求的工具。在模型服务返回 429 后,即使 Chat Model 节点已勾选”Retry on fail”并配置 5 次尝试,实际仅发出 4 个请求(前 3 次成功、最后 1 次失败),失败请求未被重试。

报错原文

OpenAI Chat Model node does not retry 429 Rate Limit errors

原因分析

最可能的原因是 OpenAI Chat Model 节点在处理模型服务返回的 429 错误时,未将其归类为符合”Retry on fail”设置的可重试错误,导致节点的重试逻辑不生效(issue 中最终确认为 bug)。由于用户使用 Cerebras API,也有评论认为是服务商侧问题,但这一判断未被采纳,issue 最终被确认为 n8n 侧缺陷并在 n8n@2.15.0 中修复。

环境排查

  • 确认 n8n 版本(问题复现版本为 2.4.4,低于修复版本 2.15.0)。
  • 确认 Chat Model 节点上的”Retry on fail”已勾选并设置尝试次数。
  • 确认所接模型服务(如 Cerebras API)及是否启用 Responses API,排除其他错误(如 “The resource could not be found”)干扰。
  • 确认部署方式(Docker 自托管)、Node.js 版本与数据库类型。

解决步骤

  1. 将 n8n 升级到 2.15.0 或更高版本(修复提交为 #27364)。
  2. 升级后重新执行原工作流,触发 429 场景。
  3. 观察 OpenAI Chat Model 节点是否按”Retry on fail”设置进行重试。
  4. 如仍不重试,可优先尝试核对所接模型服务返回的 429 响应格式是否被正确识别,并补充环境信息向 n8n 团队反馈。

验证方法

在 2.15.0 及以上版本中,于 AI Agent + OpenAI Chat Model 组合下制造 429 限流,确认节点按配置的尝试次数触发重试,而非直接终止该次执行。

参考来源

n8n-io/n8n #25136

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 33066

发表回复

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