调用量没涨多少,接口突然开始报限制,第一反应往往是「额度用完了」或者「这家站不行」。实际拆开看,拦住你的可能是账号当天的额度、同时在跑的请求数、中转站自己的队列,也可能是你本地重试写得太凶。这篇按四层给排查顺序,每层都说明怎么验证、什么情况下不适用。
调用量没涨多少,接口突然开始报限制,第一反应往往是「额度用完了」或者「这家站不行」。这两种判断都太快了。拦住你的可能是账号当天的额度,可能是同时在跑的请求数,可能是中转站自己的队列,也可能是你本地重试写得太凶。四种来源,四种解法,混在一起处理只会白折腾。
下面按四层给排查顺序,每层都说清楚怎么验证、什么情况下这条判断不成立。你可以把它当成一张排查表,从最便宜的动作开始试,别一上来就动钱。
先别急着加钱,把「限制」拆成四种
判断拦截来源,先看三条线索:响应体、状态码、时间规律。报错文案里带没带额度、重置时间、并发数这类字眼,基本就指明了是哪一层。状态码是那种明确拒绝还是超时后返回,也有区别。再看时间规律,是每次调用都触发,还是跑一阵才触发。
| 线索 | 指向的层 | 怎么确认 |
|---|---|---|
| 报错提到额度、配额、重置时间 | 账号额度层 | 看报错里给不给恢复时间,隔一段时间单发一条试探 |
| 一压就报、一停就好 | 并发层 | 降到单线程再跑同一批请求 |
| 请求到了对方但迟迟不回 | 网关或中转层 | 换一个站或换一个 Key 发同样的最小请求 |
| 同一秒日志里出现好几条相同请求 | 客户端层 | 翻日志看有没有重试循环和自动重放 |
这套判断有个明确的失效场景:如果所有接口同时报错、而且和你的调用量完全无关,那更可能是整站故障,先去服务状态页或站内公告看一眼,别在自己代码里翻半天。另外,报错文案被中转站改写过的情况很常见,字面上写的是限制,实际原因可能是上游渠道临时不可用。
额度用完和并发打满,表现完全不一样
额度类限制通常按天或按周期恢复,报错里会给重置时间;并发类限制是你一压就报、一停就好,恢复几乎是立刻的。这两个的特征差别很大,但很多人只看「能不能调通」,所以分不出来。
- 降到单线程跑一遍把并发压到 1,用同一批请求重跑。还报错,偏向额度或渠道问题;不报错了,就是并发打满。
- 看报错里的时间信息有明确重置时间戳的,按额度处理,等恢复或者换 Key;没有时间信息、只说超限的,多半是并发或频率窗口。
- 单发一条最小请求只发一个最短的请求体。通了说明是你请求本身太重或上下文太长,不通再往渠道方向查。
还有一种容易误判:额度按周期恢复,但你的业务高峰正好撞在恢复点之前,看起来像是「一整天都不行」。这种情况改代码没用,只能错峰或者提档。判断标准很简单,换个时间段跑同一批请求,能过就是时段问题。
中转站的限制,往往写在你看不到的那一层
同一个 Key 在别处能用、在某个站报限制,基本可以先怀疑渠道侧的排队或分组额度。中转站常见的限制不是明面上的次数,而是某个分组、某个上游通道的隐形配额,你从文档里看不到,只能靠对照试出来。
- 拿单条最小请求去试,先排除自己请求体过大、上下文超长这类因素
- 同一个 Key 在两个站各发一次,结果不同就说明问题在渠道侧
- 换一个分组或另一个 Key 再试,能过就是原分组的额度问题
- 挑站时把限流口径当筛选项,别只看单价,去 /rankings 和 /sites/all 对照各家的说明
- 长期依赖某一家的,提前准备好备用渠道,别等报错才找
这里的不适用情况也要说清:如果你只是偶发一两次限制,换站属于过度反应,先把客户端那层查完再说。中转站的选择标准、可信度判断,站内已经有专门页面讲,这里只提一句——把限流说明当成硬指标看,比事后救火便宜。
客户端自己踩的坑,占了一多半
重试没加退避,一次失败瞬间放大成十几次请求,这是最常见的自伤。批处理任务没分批,几百条一口气打出去,实际并发远超你以为的数字。还有一种隐蔽的:SDK 默认开了自动重试,你在业务层又包了一层重试,两层叠起来,实际请求量是平方级的。
排查顺序建议先看日志里同一秒的请求条数,再看有没有循环重试。日志里同一秒出现好几条一模一样的请求,基本可以确认是重试放大。修法不复杂:重试加指数退避,批处理按固定条数切分,SDK 自带的重试和自己写的重试只留一层。
# 最小验证:把重试层数打印出来,确认没有双层重试
import logging
logging.basicConfig(level=logging.DEBUG)
# 跑一次失败请求,看日志里同一请求出现几次这一层的好处是改完立刻见效,而且不用多花钱。建议在正式加压之前先做一次单请求验证,确认配置里只有一层重试,比事后翻日志快得多。
一套能照着走的处理顺序
四层拆完,最后给一个能照着走的顺序。原则是从改动最小、成本最低的动作开始,逐步往上加。
- 降并发到 1确认是不是并发问题。能过就停在这一步,回头改客户端的并发控制。
- 看报错里的重置时间确认是不是额度问题。有重置时间就等或换 Key,没有就往渠道方向查。
- 换 Key 或换站做对照同一请求在两个渠道各发一次,结果不同说明问题在中转层,按渠道想办法。
- 改代码里的重试和分批前三步都排除后,再动客户端逻辑。重试加退避,批处理切分,只保留一层重试。
长期做法是给调用加排队和退避,而不是等报错再救火。一个 5 人小团队哪怕只加一个简单的请求队列,也比每次限流后手动重跑省事。这里有个不适用的情况:如果业务峰值本身就超过对方给的档位,那只能换档或换供应商,改代码解决不了,别在这上面耗时间。
下一步先把各家渠道的限流说明和当前价格放在一起对照,再决定要不要换站;站内的渠道对照和价格追踪页能直接看到当时的口径和数字。→常见问题
报错说超限但请求还能返回结果,是什么情况?
多半是软限流:对方在你的请求超阈值后仍然放行一部分,只是延迟变大或偶发失败。这种不算故障,但稳定性不能依赖,建议自己按对方的档位留出余量,别贴着上限跑。
换个 Key 就不报限制了,是不是原来的 Key 被封了?
先别下这个结论。更常见的是两个 Key 属于不同分组或不同额度池,也可能原来的 Key 当天额度已经见底。换 Key 只能当对照实验用,不能当成长期解法。
并发调低了还是被限制,该往哪查?
看单次请求的体量:上下文特别长、一次带很多工具定义、或者上传大文件,都会让请求在对方那里占用更久的处理时间。把请求瘦下来再试,往往比继续降并发有效。