urllib3.util.retry.Retry 是 Python HTTP 客户端库 urllib3 中的一个核心组件，用于实现智能的请求重试机制

urllib3.util.retry.Retry 是 Python HTTP 客户端库 urllib3 中的一个核心组件，用于实现智能的请求重试机制。它在网络请求失败时自动重试请求，提高应用程序的健壮性和容错能力。以下是其核心作用详解：

核心功能

自动重试失败请求 当请求因临时性问题（如网络波动、服务器过载、HTTP 5xx 错误等）失败时，Retry 对象会自动重新发送请求，避免手动处理重试逻辑。
灵活的重试策略控制 通过参数配置重试行为，包括：
- total：最大重试次数（含首次请求）。
- connect：连接相关错误（如 DNS 解析失败、连接超时）的重试次数。
- read：读取响应超时时的重试次数。
- status：对特定 HTTP 状态码（如 5xx）的重试次数。
- backoff_factor：重试等待时间的指数退避策略（避免加重服务器负担）。
- status_forcelist：强制重试的 HTTP 状态码列表（如 [500, 502, 503]）。
- allowed_methods：允许重试的 HTTP 方法（默认仅幂等方法如 GET/HEAD/PUT/DELETE）。

典型应用场景

场景	处理方式
服务器错误 (5xx)	自动重试，直到成功或达到最大重试次数。
连接超时	重新建立连接（如 DNS 解析失败、TCP 连接超时）。
速率限制 (429)	通过 `status_forcelist=` 触发重试，并配合 `backoff_factor` 延迟等待。
临时网络故障	在连接/读取阶段自动重试。

使用示例

python 复制代码

from urllib3 import PoolManager
from urllib3.util.retry import Retry

# 配置重试策略
retry_strategy = Retry(
    total=3,                         # 最大总尝试次数（首次请求+重试）
    backoff_factor=0.5,              # 退避等待时间：0.5s → 1s → 2s
    status_forcelist=[500, 502, 503] # 强制重试的状态码
)

# 创建连接池并注入重试策略
http = PoolManager(retries=retry_strategy)

# 发送请求（自动触发重试）
response = http.request("GET", "https://example.com")

关键参数说明

参数	作用
`total`	总重试次数（包括首次请求）。
`connect`	连接错误的独立重试次数（如 DNS 失败）。
`read`	服务器响应超时的重试次数。
`status`	对 HTTP 状态码的重试次数（需配合 `status_forcelist`）。
`backoff_factor`	重试等待时间 = `backoff_factor * (2^(重试次数-1))` 秒。
`status_forcelist`	强制重试的 HTTP 状态码列表（如 `[429, 500, 502, 503, 504]`）。
`allowed_methods`	允许重试的 HTTP 方法（默认 `None`，表示仅幂等方法可重试）。

注意事项

幂等性安全 默认只重试幂等 HTTP 方法（GET/HEAD/PUT/DELETE）。若需重试 POST 等非幂等方法，需显式设置 allowed_methods=["POST"]（确保接口支持幂等）。
避免无限重试 务必设置 total 或 connect/read/status 上限，防止永久阻塞。
退避策略 backoff_factor 可缓解"惊群效应"（避免重试风暴压垮服务器）。

总结

Retry 通过封装复杂的重试逻辑（如退避等待、错误类型过滤、幂等性控制），显著简化了 HTTP 请求的容错处理。它是构建高可靠网络应用的核心工具，尤其在微服务、分布式系统中不可或缺。