重试策略与超时控制

章节：进阶篇第6章
难度：⭐⭐⭐ 进阶级
阅读时间：25-30 分钟
核心收获：掌握重试策略的设计和超时控制的最佳实践

10.1 理论要点：重试的艺术

10.1.1 重试的分类

10.1.2 重试的适用场景

可以重试： - 网络超时 - API 限流（429） - 服务暂时不可用（503） - 推送通道暂时拥堵

不可以重试： - 认证失败（401/403） - 数据源已下线 - Prompt 语法错误 - 输入数据格式错误

10.1.3 重试的代价

10.2 实战案例：三种重试策略

10.2.1 策略1：固定间隔重试

适用场景：网络超时等随机性故障

def fixed_interval_retry(func, max_retries=2, interval=10):
    for attempt in range(max_retries + 1):
        try:
            return func()
        except Timeout:
            if attempt < max_retries:
                time.sleep(interval)
                continue
            return "timeout"

优点：简单易实现
缺点：对限流服务不友好

10.2.2 策略2：指数退避重试

适用场景：API 限流、服务过载

def exponential_backoff_retry(func, max_retries=3, base_delay=1):
    for attempt in range(max_retries + 1):
        try:
            return func()
        except RateLimitError as e:
            if attempt < max_retries:
                wait_time = base_delay * (2 ** attempt)
                if hasattr(e, 'retry_after'):
                    wait_time = max(wait_time, e.retry_after)
                time.sleep(wait_time)
                continue
            return "rate_limited"

优点：给服务恢复时间
缺点：总耗时较长

10.2.3 策略3：混合策略

适用场景：复杂系统，多种故障类型

def smart_retry(func, max_retries=2):
    for attempt in range(max_retries + 1):
        try:
            return func()
        except Timeout:
            if attempt < max_retries:
                time.sleep(10)
                continue
            return "timeout"
        except RateLimitError as e:
            if attempt < max_retries:
                wait_time = parse_retry_after(e) or (2 ** attempt)
                time.sleep(wait_time)
                continue
            return "rate_limited"
        except AuthError:
            return "auth_failed"  # 不重试
    return "failed"

10.3 超时控制

10.3.1 超时分级

10.3.2 超时配置示例

Python requests：

response = requests.get(
    url,
    timeout=(5, 10)  # (连接超时, 读取超时)
)

豆包 Prompt：

每个数据源的超时设置为10秒。
如果10秒内没有响应，立即标记为超时并继续处理其他来源。

10.4 熔断器模式

10.4.1 三种状态

Closed（关闭） → Open（打开） → Half-Open（半开）
     ↓               ↓                ↓
  正常请求        快速失败         少量探测
  统计失败率      不发起请求       恢复则关闭

10.4.2 熔断器配置

10.5 图文说明

📌 待补充：建议绘制以下示意图 1. 三种重试策略对比图 2. 熔断器状态流转图 3. 超时设置决策树 4. 重试代码逻辑图

10.6 常见错误

📝 版本迭代记录