429Too Many Requests请求过多

429 Too Many Requests 表示客户端在一段时间内发送了太多请求。它是标准的限流响应,定义在 RFC 6585。

DeepSeek 娘坐在电脑前,被漫天飞来的请求单淹没。
图版 08429 Too Many Requests客户端错误

是什么意思?

响应里应该说明限制,并可以用 Retry-After 给出等待秒数或 HTTP 日期。

规范没有规定服务器如何识别用户、如何计数。限流可以按用户、IP、令牌或资源来算。

什么时候会出现?

  • API 配额或突发流量限制。
  • 反复尝试登录。
  • 爬虫或机器人流量。
  • 故障恢复后的重试风暴。

怎么处理?

如果你是开发者

  • 返回 Retry-After,并给出足够的信息,让客户端知道怎么调整。
  • 限流头要一致;不要悄悄改变时间窗口。
  • 全局过载或维护用 503,不要用 429。

如果你只是访客

  • 等到 Retry-After 指定的时间再试。
  • 用指数退避,不要在一个紧凑循环里猛重试。

技术信息

状态类
客户端错误
默认是否可缓存
否
常见响应头
Retry-After, RateLimit-*

相关状态

出处