API 限频不是墙,是节拍:429 之后该等多久

脚本突然开始返回 429,最常见的反应是把重试间隔从 1 秒改成 2 秒,然后继续撞。429 不是一道需要硬闯的墙,它是一条节拍:服务端在说「你走快了」。正确回应是标定等待时间、把节奏降下来,而不是反复敲门。

一、429 至少有四种,处理方式完全不同

同一个状态码背后可能是完全不同的原因,先分清再决定等多久:

类型 特征 正确反应 错误反应
瞬时速率超限 秒级窗口内请求过密,响应头里能看到剩余额度 按窗口等待,同时降并发 立刻重试
权重或配额用尽 分钟级、日级的总量被吃满,与瞬时速率无关 等窗口重置,减少请求量 提高频率去「抢」额度
IP 或账号级封禁 持续时间长,可能伴随 403 或专门的错误码 立即停手,查文档的错误码表 换参数继续试
服务端过载 没有请求特征,其他客户端同时受影响 退避加熔断 归因于自己的代码

HTTP 语义上,429 由 RFC 6585 定义(Too Many Requests),并允许服务端附带 Retry-After 指示建议等待时长。这是少数「服务端会主动告诉你等多久」的状态码,不用它等于放弃最可靠的信息。

二、先读响应头,再决定等多久

Retry-After 有两种合法格式(RFC 9110 第 10.2.3 节):

  • delay-seconds:一个整数秒数,例如 Retry-After: 30,直接按秒睡。
  • HTTP-date:一个绝对时间,例如 Retry-After: Sat, 31 Oct 2026 06:30:00 GMT,要用本机时间求差,注意时区与时钟漂移。

有些交易所还会在响应头里给出已用配额(形如 X-MBX-USED-WEIGHT-… 之类的自定义字段)。这类头比 429 本身更有用:它让你在被拒绝之前就知道还剩多少。字段名各平台不同,必须以各自文档为准,不要凭记忆写死。

三、指数退避的公式

没有 Retry-After 时,用指数退避把等待拉开:

wait(n) = min(cap, base × 2^(n−1))

n 是第几次重试,base 是基础等待(常见取 0.5 秒到 1 秒),cap 是上限(避免等待无限拉长)。n=1 等 base,n=2 等 2×base,n=3 等 4×base……指数增长的意义是:对方真的忙时,你的重试密度会迅速降到不打扰的程度;只是一次抖动时,第一次重试就够了。

四、抖动是必须的

只做指数退避不加抖动,会遇到同步问题:所有失败客户端在同一时刻失败,又在同一时刻重试,形成新的尖峰。三种常见做法:

  • Full jitter:等待取 random(0, wait(n)),实现最简单,削峰效果最好。
  • Equal jitter:等待 wait(n)/2 + random(0, wait(n)/2),保证有下限。
  • Decorrelated jitter:下一次等待取 random(base, 上次等待 × 3),适合长时间运行的任务。

三者都是「客户端自降节奏」的思路。AWS 架构中心的博客把带抖动的退避写成标准做法,任何自建重试都该默认带抖动,成本只是几行代码。

五、一张可以直接抄的退避表

第 n 次重试 指数等待(base=1s,cap=60s) Full jitter 后区间 累计最多占用
1 1s 0–1s 约 1s
2 2s 0–2s 约 3s
3 4s 0–4s 约 7s
4 8s 0–8s 约 15s
5 16s 0–16s 约 31s
6 32s 0–32s 约 63s
7 60s(触顶) 0–60s 约 123s

表里的数字按公式直接算出,可直接照抄;关键是先把「最多几次」定死(多数场景 5–7 次足够),超出就放弃并报错,而不是无限循环。

六、重试之前先解决幂等

对 GET 重试是安全的,对写接口重试可能造成重复业务:

  • 下单:请求其实已到达、只是响应丢了,重试就变成两笔真实订单。解决办法是复用交易所的客户端订单号(如 clientOrderId),重试时用同一个号,服务端会拒绝重复。
  • 撤单:第一次撤单成功后重试,通常返回「订单不存在」类错误。这不该当成失败重试,而应先查一次订单状态。
  • 划转与提币:多数平台不提供幂等键,重试前必须先查流水确认是否已受理,否则可能重复出金。

顺序上,在幂等性没有保证之前,任何自动重试都该关掉——宁可报错让人看一眼,也不要自动打第二枪。

七、重试预算与熔断

  • 给每个任务设重试预算:单轮最多 N 次,或总等待不超过 M 秒。
  • 全局熔断:连续 K 次 429 后暂停所有请求固定时长,不要让每个接口各自重试。
  • 主动降级:把非关键请求(行情、公告、历史 K 线)暂停,只保留交易与风控请求。

八、常见误用

  • 固定 1 秒重试,形成均匀而持续的冲击;
  • 并发重试:一批协程同时失败、同时重试,等于把请求量放大数倍;
  • 把 429 当 5xx 处理,套用同一套无限重试策略;
  • 忽略 Retry-After 的 HTTP-date 格式,把日期字符串当秒数解析,结果睡了几十年或立刻重试;
  • 签名请求重试时没更新时间戳,返回的是签名错误,把限频问题掩盖成权限问题——时间窗与漂移见 recvWindow 与时钟漂移。

配额怎么被一笔请求吃掉,见 权重预算与退避清单;密钥权限最小化见 API key 权限核对 与 三个开关别一起打开。

九、来源与访问日期

  • RFC 6585, Additional HTTP Status Codes, §4 「429 Too Many Requests」(datatracker.ietf.org,访问日期 2026-10-31)。
  • RFC 9110, HTTP Semantics, §10.2.3 「Retry-After」(访问日期 2026-10-31):两种合法格式的定义。
  • AWS Architecture Blog, Exponential Backoff And Jitter(aws.amazon.com/blogs/architecture,访问日期 2026-10-31):三种抖动策略的对比。
  • Binance API 文档,Rate limits 与 Error codes 章节(developers.binance.com,访问日期 2026-10-31):权重口径与错误码表,具体字段名以该文档当前版本为准。

风险提示:交易类接口的自动重试涉及资金安全,任何自动化都应先在只读接口上验证退避逻辑,再考虑接交易。

常见问题(FAQ)

429 之后到底等多久?

有 Retry-After 就按它等,这是服务端给出的权威值;没有就按指数退避起步,第一次等 base(约 1 秒),之后翻倍,并加抖动。不要用一个固定秒数应对所有情况,因为你不知道撞的是哪种限频。

为什么加了退避还是被继续拒绝?

常见三种原因:一是并发数没降,单次等待变长但同时在飞的请求数不变,总速率依然超标;二是撞的是分钟级或日级配额,秒级等待没有意义,必须等窗口重置;三是已经进入 IP 级封禁,此时任何频率都会被拒,只能停手查错误码。

重试会重复下单吗?

会,除非你用客户端订单号做去重。交易所通常用同一个 clientOrderId 拒绝第二笔重复订单,因此重试逻辑必须复用首次请求的订单号,而不是每次重新生成。

退避的上限该设多少?

按业务允许的延迟倒推。日内交易场景通常单轮总等待不超过几十秒,超时就转人工或报错;批处理场景可以放宽到分钟级。上限的作用是让「失败」有明确终点,而不是让进程永远等下去。

安装 App