Python接口调用时如何合理设置重试与超时策略？

在Python项目里调用第三方接口或者内部微服务时，网络延迟、服务重启、瞬时高负载都可能让某次请求失败。为了让程序更健壮，我们通常会引入超时控制和重试机制，但这两者如果设置不当，反而会带来更多问题。

为什么需要超时与重试

超时是为了防止请求无限等待，占用线程或连接资源。重试则是针对临时性故障，比如网络抖动，再次请求可能就成功了。但要注意，重试只适合幂等接口，否则可能造成重复下单或重复扣款。

使用requests设置超时

requests库的timeout参数可以分别设置连接超时和读取超时，单位为秒。下面代码演示了基本用法：

import requests

try:
    # 连接超时5秒，读取超时10秒
    resp = requests.get('https://ipipp.com/api/status', timeout=(5, 10))
    print(resp.status_code)
except requests.exceptions.Timeout:
    # 超时后可以做日志记录或降级处理
    print('请求超时，请检查网络或服务状态')

用tenacity实现重试

tenacity是一个轻量的重试库，可以用装饰器方式给函数添加重试逻辑。以下示例对接口调用函数做最多3次重试，每次间隔2秒：

from tenacity import retry, stop_after_attempt, wait_fixed
import requests

@retry(stop=stop_after_attempt(3), wait=wait_fixed(2))
def call_api():
    # 函数内调用可能失败的接口
    return requests.get('https://ipipp.com/api/data', timeout=(5, 10))

try:
    result = call_api()
    print(result.json())
except Exception as e:
    print('多次重试后仍失败:', e)

重试与超时组合建议

实际生产中，建议把超时放在每一次请求内部，重试放在函数外层。这样每次重试都会重新计时超时，不会出现总耗时失控。参考配置如下：

• 连接超时：2到5秒
• 读取超时：5到15秒，依接口复杂度调整
• 重试次数：2到3次，避免过多
• 重试间隔：采用固定或指数退避

注意事项

如果接口不是幂等的，不要盲目重试。可以在代码里用POST配合唯一请求号来防止重复处理。另外，在批量任务中，建议把失败请求写入队列异步重试，而不是同步阻塞主流程。

合理设置超时与重试，核心目标是快速失败、温和恢复，既保护调用方也保护服务提供方。

简单退避示例

from tenacity import retry, stop_after_attempt, wait_exponential

@retry(stop=stop_after_attempt(4), wait=wait_exponential(multiplier=1, min=2, max=10))
def safe_call():
    # 指数退避，避免同时重试打爆服务
    return requests.get('https://ipipp.com/api/slow', timeout=(5, 20))

通过以上方式，你可以在Python中构建清晰、可控的接口调用策略，提升系统稳定性。

Python接口调用重试超时修改时间：2026-07-28 03:21:19