指数退避重试是在接口调用失败后延迟再试，等待时间按指数增长（如1s→2s→4s），避免压垮服务；推荐用tenacity库实现，支持同步/异步、可配置上下限与异常类型，手写版可用time+random实现，需注意错误分类、最大重试次数、日志及幂等性。

什么是指数退避重试

接口调用失败时，不立即重试，而是等待一段时间后再试；每次失败后，等待时间按指数增长（如 1s → 2s → 4s → 8s），避免短时间高频重试压垮服务或被限流。这是比固定间隔更健壮的重试策略。

用 tenacity 库最简单可靠

Python 生态中推荐使用 tenacity —— 功能完整、可读性高、支持异步、内置指数退避。

安装：

pip install tenacity

基本用法示例（同步 HTTP 请求）：

CodeSnippets

AI代码生成、补全、分析、重构和调试

from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
import requests
@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
def retry_with_backoff(max_tries=3, base_delay=1, max_delay=60, jitter=True):
def decorator(func):
@wraps(func)
def wrapper(*args, *kwargs):
for i in range(max_tries + 1):
try:
return func(args, **kwargs)
except Exception as e:
if i == max_tries:
raise e
计算退避时间：base_delay * 2^i
                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 秒后继续”

幂等性前提：确保重试的接口是幂等的（多次调用效果一致），否则可能引发重复下单、重复扣款等问题