Python Requests Timeout：如何优雅地处理请求超时问题|极客教程

Python Requests Timeout：如何优雅地处理请求超时问题

1. 引言

在网络请求过程中，由于网络环境、服务器性能等因素，很可能出现请求超时的情况。超时问题对于开发者来说是一个常见而且需要重视的问题。为了能够优雅地处理请求超时，我们可以使用 Python 中的 requests 库提供的超时设置功能。本文将详细介绍 Python 中如何使用 requests 库来设置超时参数，并通过示例代码演示其运行结果。

2. requests 库介绍

requests 是 Python 中广泛使用的网络请求库，它提供了简洁而强大的 API，可以方便地发送 HTTP 请求，处理响应，以及处理请求的各种情况。在处理网络请求时，请求超时是一个需要经常关注和处理的问题。

3. 设置请求超时参数

在 requests 中，可以通过 timeout 参数设置请求的超时时间，单位为秒。当请求超时时，可以通过捕获 requests.exceptions.Timeout 异常来处理超时情况。下面是一段示例代码演示了如何设置请求超时参数：

import requests

try:
    response = requests.get('https://example.com', timeout=5)
    print(response.text)
except requests.exceptions.Timeout:
    print('请求超时')

上述代码中，将超时时间设置为 5 秒，如果请求时间超过了 5 秒，则会抛出 Timeout 异常。在捕获 Timeout 异常后，我们可以根据实际需求进行相应处理。

4. 设置连接超时和读取超时

在 requests 中，超时参数可以分为连接超时和读取超时两部分。连接超时是指建立连接的时间，如果超过了指定的时间仍未建立连接，则会抛出 Timeout 异常。读取超时是指在建立连接后，从服务器读取数据的时间，如果超过了指定的时间仍未完成数据的读取，则同样会抛出 Timeout 异常。下面是一段示例代码演示了如何设置连接超时和读取超时：

import requests

try:
    response = requests.get('https://example.com', timeout=(3, 5))
    print(response.text)
except requests.exceptions.Timeout:
    print('请求超时')

上述代码中，将连接超时设置为 3 秒，读取超时设置为 5 秒。超过连接超时时间或读取超时时间后，会抛出 Timeout 异常。根据不同的需求，可以灵活地设置连接超时和读取超时的时间。

5. 设置请求重试

除了设置超时时间外，有时候还需要对请求进行重试，以应对网络不稳定或服务器繁忙等情况。requests 提供了 Retry 类来实现请求重试功能。下面是一段示例代码演示了如何设置请求重试：

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

retry_strategy = Retry(
    total=3,
    backoff_factor=0.1,
    status_forcelist=[500, 502, 503, 504],
)
adapter = HTTPAdapter(max_retries=retry_strategy)
http = requests.Session()
http.mount("https://", adapter)

try:
    response = http.get('https://example.com', timeout=5)
    print(response.text)
except requests.exceptions.Timeout:
    print('请求超时')
except requests.exceptions.RequestException as e:
    print('请求异常:', e)

上述代码中，通过创建一个 Session 对象，并使用 HTTPAdapter 和 Retry 设置重试策略，来实现请求的重试功能。其中，total 参数指定了最大重试次数，backoff_factor 参数指定了重试的间隔时间因子，status_forcelist 参数指定了在遇到指定的状态码时进行重试。在捕获 Timeout 异常或其他请求异常后，可以根据实际需求进行相应处理。

6. 设置连接池大小

在请求超时问题中，如果同时发送大量的请求，可能会导致连接池耗尽，从而出现连接超时的问题。为了解决这个问题，可以通过对连接池大小进行设置。下面是一段示例代码演示了如何设置连接池大小：

import requests

session = requests.Session()
adapter = requests.adapters.HTTPAdapter(pool_maxsize=10)
session.mount('https://', adapter)

try:
    response = session.get('https://example.com', timeout=5)
    print(response.text)
except requests.exceptions.Timeout:
    print('请求超时')

上述代码中，通过创建一个 Session 对象，并使用 HTTPAdapter 设置连接池的最大大小为 10，来控制并发请求的数量。根据实际需求，可以调整连接池的大小。

7. 结论

在网络请求过程中，请求超时问题是很常见的情况。为了能够优雅地处理请求超时，我们可以使用 Python 中的 requests 库，并通过设置超时参数、重试策略以及连接池大小等方式来进行处理。本文介绍了如何使用 requests 库来设置请求超时参数，并给出了示例代码来演示运行结果。通过合理设置超时参数和重试策略，可以帮助我们更好地应对请求超时问题，提升程序的稳定性和可靠性。