Function retry_with_backoff

src/core/utils.py:200–253

带有指数退避的重试装饰器/函数 Args: func: 要重试的函数 max_retries: 最大重试次数 base_delay: 基础延迟（秒） max_delay: 最大延迟（秒） backoff_factor: 退避因子 exceptions: 要捕获的异常类型 Returns: 函数的返回值 Raises: 最后一次尝试的异常

(
    func: Callable,
    max_retries: int = 3,
    base_delay: float = 1.0,
    max_delay: float = 30.0,
    backoff_factor: float = 2.0,
    exceptions: tuple = (Exception,)
)

def retry_with_backoff(
    func: Callable,
    max_retries: int = 3,
    base_delay: float = 1.0,
    max_delay: float = 30.0,
    backoff_factor: float = 2.0,
    exceptions: tuple = (Exception,)
) -> Any:
    """
    带有指数退避的重试装饰器/函数

    Args:
        func: 要重试的函数
        max_retries: 最大重试次数
        base_delay: 基础延迟（秒）
        max_delay: 最大延迟（秒）
        backoff_factor: 退避因子
        exceptions: 要捕获的异常类型

    Returns:
        函数的返回值

    Raises:
        最后一次尝试的异常
    """
    last_exception = None

    for attempt in range(max_retries + 1):
        try:
            return func()
        except exceptions as e:
            last_exception = e

            # 如果是最后一次尝试，直接抛出异常
            if attempt == max_retries:
                break

            # 计算延迟时间
            delay = min(base_delay * (backoff_factor ** attempt), max_delay)

            # 添加随机抖动
            delay *= (0.5 + random.random())

            # 记录日志
            logger = logging.getLogger(__name__)
            logger.warning(
                f"尝试 {func.__name__} 失败 (attempt {attempt + 1}/{max_retries + 1}): {e}. "
                f"等待 {delay:.2f} 秒后重试..."
            )

            time.sleep(delay)

    # 所有重试都失败，抛出最后一个异常
    raise last_exception


class RetryDecorator: