python使用 requests 设置读取超时时间

目录

一、设置读取超时时间的原理

二、设置读取超时时间的必要性

三、如何设置读取超时时间

四、如何处理超时异常

五、总结

---

在 Python 中，使用 requests 库进行网络请求时，可以通过设置 timeout 参数来指定读取超时时间。这可以帮助我们在规定时间内获取到响应，如果超过规定时间还未收到响应，则请求会抛出异常。下面我将结合代码，详细介绍如何设置 requests 的读取超时时间，并阐述其中的原理和逻辑。

一、设置读取超时时间的原理

在 requests 中，设置读取超时时间是通过传递一个包含读取超时时间的元组给 timeout 参数来实现的。该元组包含两个值：连接超时时间（connect timeout）和读取超时时间（read timeout）。连接超时时间是指建立连接的超时时间，而读取超时时间是指从服务器获取响应数据的超时时间。

例如，以下代码将设置连接超时时间为 2 秒，读取超时时间为 3 秒：

import requests  
  
response = requests.get('http://example.com', timeout=(2, 3))

如果服务器在 2 秒内没有建立连接，或者在 3 秒内没有返回响应数据，那么请求将抛出 requests.exceptions.Timeout 异常。

二、设置读取超时时间的必要性

在某些情况下，网络延迟或服务器响应速度较慢可能会导致请求长时间没有响应。如果不设置读取超时时间，程序会一直等待响应，从而浪费大量时间和资源。因此，设置读取超时时间可以避免程序长时间等待，提高程序的响应性和用户体验。

另外，设置读取超时时间还可以帮助我们识别网络连接问题或服务器故障。如果请求因为网络故障或服务器故障而无法在规定时间内获得响应，设置读取超时时间可以帮助我们及时发现并处理这些问题。

三、如何设置读取超时时间

设置读取超时时间的方法很简单，只需要在调用 requests 函数时，将一个包含读取超时时间的元组传递给 timeout 参数即可。例如：

import requests  
  
response = requests.get('http://example.com', timeout=(2, 3))

以上代码中，timeout 参数接受一个元组 (connect timeout, read timeout)，其中 connect timeout 是建立连接的超时时间，read timeout 是从服务器获取响应数据的超时时间。这里我们将 connect timeout 设置为 2 秒，将 read timeout 设置为 3 秒。如果请求在规定时间内没有获得响应，那么将抛出 requests.exceptions.Timeout 异常。

四、如何处理超时异常

在设置读取超时时间后，我们需要考虑如何处理可能出现的超时异常。通常情况下，我们可以使用 try-except 语句块来捕获和处理超时异常。例如：

import requests  
  
try:  
    response = requests.get('http://example.com', timeout=(2, 3))  
    # 处理响应数据  
    print(response.text)  
except requests.exceptions.Timeout:  
    print('请求超时！')

以上代码中，我们使用 try-except 语句块来捕获 requests.exceptions.Timeout 异常。如果请求在规定时间内没有获得响应，那么将触发该异常，程序将执行 except 块中的代码，打印出提示信息。这样我们就可以及时发现和处理超时问题。

除了处理超时异常，还可以通过设置重试次数来增强程序的鲁棒性。当请求超时或发生其他错误时，程序可以尝试重新发送请求。例如：

import requests  
from requests.adapters import HTTPAdapter  
from requests.packages.urllib3.util.retry import Retry  
  
retry_strategy = Retry(  
    total=3,  
    status_forcelist=[500, 502, 503, 504],  
    method_whitelist=["HEAD", "GET", "OPTIONS"]  
)  
  
adapter = HTTPAdapter(max_retries=retry_strategy)  
  
session = requests.Session()  
session.mount("http://", adapter)  
session.mount("https://", adapter)  
  
try:  
    response = session.get('http://example.com', timeout=(2, 3))  
    # 处理响应数据  
    print(response.text)  
except requests.exceptions.RequestException:  
    print('请求出错！')

以上代码中，我们使用 requests.adapters.HTTPAdapter 和 requests.packages.urllib3.util.retry.Retry 来设置请求重试策略。这里我们将重试次数设置为 3，只针对状态码为 500、502、503、504 的情况进行重试，并且只对 "HEAD"、"GET"、"OPTIONS" 这几种请求方法进行重试。然后我们将这个重试策略挂载到 requests.Session 上，这样所有的请求都会应用这个策略。这样即使有请求失败，程序也可以自动进行重试，增强了程序的鲁棒性。

五、总结

通过设置读取超时时间和请求重试策略，我们可以更好地处理网络请求中可能出现的异常情况，增强程序的响应性和鲁棒性。在实际应用中，我们可以根据具体情况灵活运用这两种技术，以适应不同的需求和场景。