如何配置backoff装饰器参数实现函数最多10次间隔重试？

原代码的核心问题 #

1. 异常被内部吞掉：你的do_it函数里用try-except捕获了所有异常并返回字符串，backoff装饰器根本感知不到异常发生，自然不会触发重试逻辑。
2. 装饰器参数不完整：@backoff.on_exception的第一个参数必须指定重试的等待策略生成器，你只传了max_tries，参数顺序完全错误。

正确的参数配置说明 #

backoff.on_exception的必填参数顺序是：

1. 等待生成器：要实现0.5-1.5秒的随机间隔，直接用backoff.random_exponential，通过min=0.5和max=1.5锁定间隔范围。
2. 捕获的异常类型：要捕获任意异常，传入Exception即可；如果只需要捕获特定异常（比如网络错误、除零错误），可以传入对应的异常类列表。
3. 可选参数：max_tries=10指定最多尝试10次（包含第一次调用，也就是最多重试9次）。

修改后的完整代码 #

import backoff
import random

x = 0

# 配置装饰器：随机间隔0.5-1.5秒，捕获所有异常，最多尝试10次
@backoff.on_exception(backoff.random_exponential, Exception, max_tries=10, jitter=None)
def do_it():
    global x
    x += 1
    print(f'x: {x}')
    # 去掉内部吞异常的try-except，让异常抛给backoff处理
    z = downloaded_from_somewhere('http://somewhere.com/z')  # 假设这个函数会抛出网络异常
    y = 1/z  # z为0时抛出ZeroDivisionError
    return y

# 模拟下载失败的函数
def downloaded_from_somewhere(url):
    # 模拟随机失败或返回0
    if random.random() > 0.3:
        raise ConnectionError("Download failed")
    return 0

do_it()

关键改动说明 #

• 移除了内部的try-except块，让异常直接抛出，backoff才能检测到并触发重试。
• 调整了@backoff.on_exception的参数顺序，指定了正确的等待策略和异常类型。
• 添加了jitter=None，因为random_exponential默认会加额外抖动，我们已经通过min和max固定了范围，不需要额外抖动。

可选：自定义重试回调 #

如果需要在每次重试前打印日志或执行其他操作，可以添加on_backoff参数：

def backoff_handler(details):
    print(f"重试第{details['tries']}次，上次异常：{details['exception']}")

@backoff.on_exception(
    backoff.random_exponential,
    Exception,
    max_tries=10,
    jitter=None,
    on_backoff=backoff_handler
)
def do_it():
    # ... 函数内容不变

内容的提问来源于stack exchange，提问作者Nanno