最可靠方式是显式检查response.status_code == 429;若用raise_for_status(),需在HTTPError异常中二次校验e.response.status_code;重试应结合Retry-After头解析(数字或HTTP日期)并配合urllib3.Retry定制策略,禁用backoff_factor以防叠加。

requests调用API返回429时怎么判断
直接检查response.status_code是否等于429,这是最可靠的方式。不要依赖异常——requests默认不会为4xx/5xx状态码抛出异常,response.raise_for_status()才会触发HTTPError,但捕获后仍需检查e.response.status_code才能确认是429。
常见错误是写成except requests.exceptions.HTTPError就以为能区分429,结果其他4xx(比如404、401)也进来了,逻辑被意外覆盖。
- 推荐写法:先发请求,再显式判断
if response.status_code == 429 - 如果用了
raise_for_status(),必须在except requests.exceptions.HTTPError里二次检查e.response.status_code == 429 - 注意:某些代理或网关可能把429转成503或自定义状态码,此时要结合
response.headers.get("Retry-After")和响应体关键词(如"rate limit")辅助判断
捕获429后怎么自动重试
别手写while循环+sleep——容易漏掉Retry-After头,或在无限制重试中触发更严惩罚。用urllib3.util.Retry配合requests.adapters.HTTPAdapter才是标准做法。
Retry支持按状态码定制重试策略,429必须单独加进status_forcelist;否则默认只重试连接类错误和5xx。
- 示例配置:
from urllib3.util import Retry<br>from requests.adapters import HTTPAdapter<br><br>retry_strategy = Retry(<br> total=3,<br> status_forcelist=[429], # 关键:必须显式加入<br> allowed_methods=["HEAD", "GET", "POST"],<br> backoff_factor=1<br>)<br>adapter = HTTPAdapter(max_retries=retry_strategy)
-
backoff_factor=1表示首次重试延迟1秒,第二次2秒,第三次4秒(指数退避) - 若响应含
Retry-After: 5,urllib3会优先用这个值,覆盖backoff_factor
如何从响应头提取Retry-After并控制等待时间
Retry-After可能是整数秒(如"5"),也可能是HTTP日期字符串(如"Wed, 21 Oct 2024 07:28:00 GMT")。requests不自动解析它,得自己处理。
多数API返回的是数字,直接int(response.headers.get("Retry-After", "1"))就行;但遇到日期格式必须用email.utils.parsedate_to_datetime()转时间戳,再减去当前时间算秒数。
- 安全做法:用
try/except ValueError兜底,失败时退回到固定等待(如1秒) - 注意时区:
parsedate_to_datetime()返回带tzinfo的datetime,与datetime.now()比较前要统一时区(建议全用UTC) - 别盲目sleep——加个超时保护,比如最大等30秒,避免被恶意头拖住
异步场景下aiohttp怎么处理429
aiohttp.ClientSession不会自动重试,也不解析Retry-After。你得在await response.json()或await response.text()之后手动检查状态码,再用asyncio.sleep()暂停。
关键点是:不能在session.get()外层套try/except就完事,因为aiohttp的ClientResponseError需要显式启用raise_for_status=True参数,否则response.status还是得手动读。
- 发起请求时加
raise_for_status=True,然后except aiohttp.ClientResponseError as e:,再判e.status == 429 - 获取
Retry-After后,用await asyncio.sleep(delay),不是time.sleep() - 多次重试建议封装成协程函数,用
for attempt in range(3):控制次数,每次失败后计算delay并await
真正麻烦的不是识别429,而是它常伴随动态限流窗口(比如每分钟100次,但窗口不是整点对齐)、多级限流(IP级+token级)、以及不同API对Retry-After的实现差异——有些返回秒数,有些返回毫秒,有些干脆不返回。上线前一定用真实限流环境测一遍等待逻辑。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











