在Python中如何通过Retrying库优雅实现API调用的自动重试？-Python教程-PHP中文网

tenacity是retrying的官方推荐替代库，支持同步/异步、类型提示完善、重试条件可组合，且兼容Python 3.11+；迁移只需将@retry替换为@retry(stop=stop_after_attempt(3))等配置。

在python中如何通过retrying库优雅实现api调用的自动重试？

Retrying库不维护了，直接换 `tenacity`

如果你刚 pip install retrying，会发现它在 Python 3.11+ 上无法安装，且自 2019 年起已停止维护。官方推荐替代方案是 tenacity——功能更全、类型提示完善、错误处理更清晰。

常见错误现象：ImportError: No module named 'retrying' 或 TypeError: 'RetryError' object is not subscriptable（老版本与新 asyncio 不兼容）。

用 pip install tenacity 替代 pip install retrying
tenacity 默认支持同步/异步、可组合重试条件（比如“超时 + 网络错误”才重试），而 retrying 的 @retry 装饰器对异常类型判断较粗糙
迁移成本低：把 @retry 换成 @retry(stop=stop_after_attempt(3)) 即可起步

如何让 requests 请求只在特定 HTTP 状态码下重试？

盲目重试 400、401、422 这类客户端错误没意义，反而可能触发风控；真正该重试的是 5xx 或连接中断这类临时性故障。

使用 retry_if_exception + 自定义判断逻辑最稳妥：

from tenacity import retry, stop_after_attempt, retry_if_exception
import requests
<p>def is_server_error_or_connection_error(exc):
return isinstance(exc, requests.RequestException) and (
hasattr(exc.response, 'status_code') and 500 </p><p>@retry(
stop=stop_after_attempt(3),
retry=retry_if_exception(is_server_error_or_connection_error)
)
def call_api(url):
return requests.get(url, timeout=5)
</p>

别依赖 status_code 属性直接访问——exc.response 在连接失败时为 None，必须先判空或捕获 AttributeError
建议把超时设短（如 3–5 秒），避免重试拖长整体耗时；tenacity 默认无 jitter，加上 wait=wait_exponential(multiplier=1, min=1, max=10) 更友好
如果用 httpx，同理检查 exc.response.status_code 或 exc.__cause__ 是否含网络错误

重试时怎么避免敏感参数被重复打印到日志？

默认情况下，tenacity 在重试失败时会把整个函数调用栈和参数原样打到日志里，如果 call_api(url, headers={'Authorization': 'Bearer xxx'})，token 就会明文泄露。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

用 before=before_log(logger, logging.DEBUG) 会记录所有参数；改用 before=before_nothing() 关闭自动日志，自己控制输出
或者重写 before 回调，对敏感字段做脱敏处理：
def before_log_redacted(retry_state): logger.debug("Calling API (url redacted, auth: *** )")
更彻底的做法：把 token 放进 session 实例或全局配置，不在函数参数中传递认证信息

异步 API 调用（aiohttp/httpx）怎么加重试？

同步重试装饰器不能直接套在 async def 函数上，否则会报 RuntimeWarning: coroutine 'xxx' was never awaited。

必须用 tenacity 提供的异步支持：

from tenacity import AsyncRetrying, stop_after_attempt, wait_exponential
import httpx
<p>@AsyncRetrying(
stop=stop_after_attempt(3),
wait=wait_exponential(multiplier=1, min=1, max=10),
reraise=True
)
async def fetch_data(client: httpx.AsyncClient, url: str):
response = await client.get(url)
response.raise_for_status()
return response.json()
</p>

注意：必须显式传入 reraise=True，否则异常会被吞掉，函数返回 None
不要在重试装饰器内创建 AsyncClient 实例——连接池应复用，否则每轮重试都新建 client，可能触发 “Too many open files”
若混用 sync/async 场景，别共用同一个重试策略实例；AsyncRetrying 和 Retrying 是不同类

重试逻辑越靠近真实错误原因越有效，比如区分 DNS 失败、SSL 握手失败、503 Service Unavailable，这些在 tenacity 里都能拆开定制，但多数人只配个次数就上线——结果是重试了，问题还在。