指数退避重试是在接口调用失败后延迟再试，等待时间按指数增长（如1s→2s→4s），避免压垮服务；推荐用tenacity库实现，支持同步/异步、可配置上下限与异常类型，手写版可用time+random实现，需注意错误分类、最大重试次数、日志及幂等性。
什么是指数退避重试
接口调用失败时，不立即重试，而是等待一段时间后再试；每次失败后，等待时间按指数增长（如 1s → 2s → 4s → 8s），避免短时间高频重试压垮服务或被限流。这是比固定间隔更健壮的重试策略。
用 tenacity 库最简单可靠
Python 生态中推荐使用 tenacity —— 功能完整、可读性高、支持异步、内置指数退避。
安装：
pip install tenacity基本用法示例（同步 HTTP 请求）：
立即学习“Python免费学习笔记（深入）”；
from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type import requests <p>@retry( stop=stop_after_attempt(3), # 最多重试 3 次（共请求 4 次） wait=wait_exponential(multiplier=1, min=1, max=10), # 初始等待 1s，指数增长，上限 10s retry=retry_if_exception_type((requests.exceptions.Timeout, requests.exceptions.ConnectionError)) ) def fetch_data(url): response = requests.get(url, timeout=5) response.raise_for_status() return response.json()
说明：
- multiplier=1：第一次重试前等 1×2⁰ = 1 秒；第二次等 1×2¹ = 2 秒；第三次等 1×2² = 4 秒
- min=1, max=10：确保等待时间不小于 1 秒、不大于 10 秒（防止退避过长）
- 只对指定异常重试，避免对 404、400 等业务错误误重试
不用第三方库：手写指数退避装饰器
若项目限制依赖，可用标准库 time 和 random 实现简易版：
import time
import random
from functools import wraps
<p>def retry_with_backoff(max_tries=3, base_delay=1, max_delay=60, jitter=True):
def decorator(func):
@wraps(func)
def wrapper(*args, *<em>kwargs):
for i in range(max_tries + 1):
try:
return func(</em>args, **kwargs)
except Exception as e:
if i == max_tries:
raise e</p><h1>计算退避时间：base_delay * 2^i</h1><pre class="brush:php;toolbar:false;"> delay = min(base_delay * (2 ** i), max_delay)
# 加入随机抖动，避免大量请求同时重试
if jitter:
delay *= random.uniform(0.5, 1.5)
delay = round(delay, 2)
time.sleep(delay)
return None
return wrapper
return decorator使用示例
@retry_with_backoff(max_tries=3, base_delay=1) def call_api():
模拟可能失败的请求
if random.random() < 0.7: # 70% 概率失败
raise ConnectionError("Network error")
return "success"
关键注意事项
- 区分错误类型：网络超时、连接拒绝可重试；401（未授权）、404（不存在）、400（参数错误）通常不该重试
- 设置最大重试次数和总超时：避免无限等待，例如 3 次重试 + 指数退避后总耗时可能超 15 秒，需配合请求级 timeout 控制
- 日志记录重试行为：便于排查问题，比如 “第 2 次重试，等待 2.3 秒后继续”
- 幂等性前提：确保重试的接口是幂等的（多次调用效果一致），否则可能引发重复下单、重复扣款等问题
