http-429

HTTP 429 Too Many Requests 的定位与处理

现象

客户端收到 429 Too Many Requests，通常带 Retry-After 或 X-RateLimit-* 响应头。可能是限流策略、突发流量、重试风暴或共享出口 IP。

快速定位

curl -v http://<host>/api
curl -sI http://<host>/api | grep -i -E 'retry-after|ratelimit|x-rate'
nginx -T | grep -nE 'limit_req|limit_conn'
tail -f /var/log/nginx/error.log

常见根因

1. 单 IP/单用户的请求速率超过阈值。
2. 客户端重试没有退避，放大流量。
3. NAT/代理后大量用户共享一个出口 IP。
4. 限流窗口/burst 配置过严。
5. 上游 API 或网关有自己的配额。

修复

• 客户端遵守 Retry-After，加入指数退避和 jitter。
• 降低并发，合并请求，使用缓存。
• 服务端按用户/租户限流，而不是只看 IP。
• 调整 limit_req 的 rate/burst 和 limit_conn。
• 对可信来源配置白名单，或使用 API key 区分配额。
• 监控 429 比例和限流命中，避免误伤正常流量。

相关命令

• nginx — 限流配置
• curl — 查看响应头
• promtool — 限流指标