Python requests请求之timeout参数

1. 介绍

在网络请求过程中，我们经常会遇到一些网络不稳定或者服务器响应速度较慢的情况。为了避免程序长时间等待或者阻塞，我们可以使用timeout参数来设置请求的超时时间。本文将详细介绍Python requests库中的timeout参数的使用方法以及一些注意事项。

2. requests库简介

requests是一个非常强大的Python库，用于发送HTTP请求。它支持多种请求方法，如GET、POST等，并且提供了简洁易用的接口，使得操作HTTP请求变得非常方便。

使用requests库发送HTTP请求的基本流程如下：
1. 导入requests库：import requests
2. 发送请求并获取响应：response = requests.get(url)
3. 处理响应数据：print(response.text)

3. timeout参数的作用

timeout参数用于设置请求的超时时间，即当请求发送出去后，若在指定的时间内没有得到响应，则会抛出一个异常。这个异常是requests.exceptions.Timeout类型的异常。

timeout参数有两种传值方式：
– 一个浮点数：表示等待服务器响应的时间，单位为秒。若在指定时间内服务器没有响应，则会抛出Timeout异常。
– 一个元组：包含两个浮点数，分别表示连接超时时间和读取超时时间。连接超时时间是指建立连接的时间，读取超时时间是指从服务器接收响应数据的时间。

下面分别介绍这两种传值方式的使用方法。

3.1 一个浮点数的超时时间

当timeout参数为一个浮点数时，表示等待服务器响应的时间。如果在指定时间内没有得到响应，会抛出Timeout异常。

import requests

try:
    response = requests.get(url, timeout=5)
    print(response.text)
except requests.exceptions.Timeout:
    print("请求超时")

在上面的例子中，timeout参数被设置为5秒，如果请求的响应时间超过5秒，则会抛出Timeout异常。

3.2 一个元组的超时时间

当timeout参数为一个元组时，元组中的第一个值表示连接超时时间，第二个值表示读取超时时间。如果在指定时间内连接或读取操作没有完成，会抛出Timeout异常。

import requests

try:
    response = requests.get(url, timeout=(3, 7))
    print(response.text)
except requests.exceptions.Timeout:
    print("请求超时")

在上面的例子中，连接超时时间被设置为3秒，读取超时时间被设置为7秒。如果连接或读取操作超过了对应的时间限制，则会抛出Timeout异常。

4. timeout参数的注意事项

在使用timeout参数时，我们需要注意以下几点：

4.1 timeout的取值范围

timeout参数的取值范围可以是任意正数或者一个元组。如果timeout参数不满足这个条件，则会抛出一个ValueError异常。

import requests

try:
    response = requests.get(url, timeout=-1)
    print(response.text)
except ValueError:
    print("timeout参数不合法")

在上面的例子中，由于timeout参数被设置为负数，不满足timeout参数的取值范围要求，所以会抛出ValueError异常。

4.2 timeout参数的单位

timeout参数的单位是秒。也就是说，timeout参数的值表示的是等待服务器响应的时间或者连接/读取超时时间的秒数。

import requests

try:
    response = requests.get(url, timeout=0.5)
    print(response.text)
except requests.exceptions.Timeout:
    print("请求超时")

在上面的例子中，timeout参数被设置为0.5秒，即等待服务器响应的时间为0.5秒。如果服务器在0.5秒内没有响应，则会抛出Timeout异常。

4.3 timeout参数的优先级

timeout参数的优先级高于requests库的默认设置。也就是说，如果timeout参数被设置了，则会覆盖requests库的默认超时设置。

import requests

try:
    # 默认超时时间为5秒
    response = requests.get(url)
    print(response.text)
except requests.exceptions.Timeout:
    print("请求超时")

在上面的例子中，timeout参数没有被设置，因此使用了requests库的默认超时时间（5秒）。

import requests

try:
    # 超时时间设置为1秒
    response = requests.get(url, timeout=1)
    print(response.text)
except requests.exceptions.Timeout:
    print("请求超时")

在上面的例子中，timeout参数被设置为1秒，因此请求的超时时间变为1秒，覆盖了requests库的默认超时设置。

5. 总结

本文介绍了Python requests库中的timeout参数的使用方法以及注意事项。timeout参数用于设置请求的超时时间，可以是一个浮点数表示等待服务器响应的时间，也可以是一个元组表示连接超时时间和读取超时时间。在使用timeout参数时，我们需要注意：timeout的取值范围、timeout的单位以及timeout的优先级。

requests库是一个功能强大、简单易用的HTTP请求库，通过合理地使用timeout参数，我们可以避免程序长时间等待或者阻塞的问题，提高程序的稳定性和性能。