api resource_error ai_generated partial

429请求过多：Retry-After头值格式错误或缺失

429 Too Many Requests: Retry-After header value is malformed or missing

ID: api/rate-limit-exceeded-retry-after-malformed

其他格式: JSON · Markdown 中文 · English
70%修复率
80%置信度
1证据数
2024-08-01首次发现

版本兼容性

版本状态引入弃用备注
Nginx 1.24.0 active — — —
Cloudflare 2024 active — — —
AWS API Gateway 2024 active — — —
Kong 3.5.0 active — — —

根因分析

服务器返回429，但Retry-After头格式无效（例如非数字、负数或完全缺失），导致客户端无法实现正确的退避。

English

Server returns 429 with a Retry-After header that has an invalid format (e.g., non-numeric, negative, or missing entirely), causing clients to fail to implement proper backoff.

generic

官方文档

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After

解决方案

  1. 实现健壮的Retry-After解析，处理秒数和HTTP日期格式：`const retryAfter = response.headers.get('Retry-After'); let delay; if (retryAfter && /^\d+$/.test(retryAfter)) { delay = parseInt(retryAfter) * 1000; } else if (retryAfter) { delay = new Date(retryAfter).getTime() - Date.now(); } else { delay = 5000; }`
  2. 当Retry-After缺失时，使用带抖动的指数退避作为回退：`delay = Math.min(60000, Math.pow(2, attempt) * 1000 + Math.random() * 1000)`
  3. 联系API提供商修复Retry-After头格式，同时宽松解析（例如提取第一个数值）

无效尝试

常见但无效的做法:

  1. 80% 失败

    Hardcoding a fixed retry delay (e.g., 5 seconds) instead of parsing Retry-After

  2. 90% 失败

    Ignoring Retry-After and retrying immediately, causing repeated 429 responses

  3. 65% 失败

    Assuming Retry-After is always in seconds (when it could be an HTTP-date)