了解Python中的requests.packages.urllib3.util.retryRetry()用法和示例

requests.packages.urllib3.util.retry.Retry()是一个用于配置请求重试的类。它允许我们指定在请求失败时应进行的重试次数，重试方法以及重试间隔时间。Retry类是requests库的一部分，通过urllib3.util.retry模块暴露给开发者使用。

Retry类的构造函数签名为：

Retry(total=10, connect=None, read=None, redirect=None, status=None, method_whitelist=False, backoff_factor=0, status_forcelist=(500, 502, 503, 504))

下面是Retry类的主要参数：

- total：重试的最大次数(包括初始请求)。默认为10。

- connect：连接超时时间的重试次数。默认为None，不进行连接超时重试。

- read：读取超时时间的重试次数。默认为None，不进行读取超时重试。

- redirect：重定向的重试次数。默认为None，不进行重定向重试。

- status：非200状态码的重试次数。默认为None，不进行非200状态码重试。

- method_whitelist：只对指定的请求方法进行重试。默认为False，对所有请求方法进行重试。

- backoff_factor：重试间隔时间的衰减因子。每次重试都会以指数级增加重试间隔时间，该参数指定了衰减因子的大小。默认为0，即不进行衰减。

- status_forcelist：强制重试的状态码列表。默认为(500, 502, 503, 504)，表示当响应状态码为500、502、503或504时，都会强制进行重试。

Retry类提供了一些方法来控制请求重试的行为：

- Retry.increment重试次数增加方法：增加Retry对象的重试次数。

- Retry.__next__：返回一个新的Retry对象，重试次数加1。

- Retry.from_int：根据指定的整数值创建一个Retry对象。

下面是使用Retry类的一个示例：

import requests
from requests.packages.urllib3.util.retry import Retry
from requests.adapters import HTTPAdapter

# 创建一个Retry对象，并设置重试次数为3
retry = Retry(total=3)

# 创建一个HTTPAdapter对象，并将Retry对象绑定到该适配器
adapter = HTTPAdapter(max_retries=retry)

# 创建一个Session对象，并将HTTPAdapter对象绑定到该会话中
session = requests.Session()
session.mount('http://', adapter)

# 发送HTTP请求，并进行重试
response = session.get('http://example.com')

# 输出响应的状态码和内容
print(response.status_code)
print(response.text)

在上面的示例中，我们首先创建了一个Retry对象，并将重试次数设置为3。然后，我们创建了一个HTTPAdapter对象，并将Retry对象绑定到该适配器中。接下来，我们创建了一个Session对象，并将HTTPAdapter对象绑定到该会话中。最后，我们通过该会话对象发送HTTP请求，并进行重试。最终，我们输出了响应的状态码和内容。

总结：

使用requests.packages.urllib3.util.retry.Retry()可以方便地配置请求重试的行为，例如重试次数、重试间隔时间等。通过配置Retry对象，可以使得请求在失败时尝试多次，增加请求的成功率。在实际开发中，我们可以根据需求来调整Retry对象的参数，以达到 的请求重试效果。