Pythonrequests.sessionsSession()的连接超时设置

Python requests 库提供了一个 Session 对象来管理和维护一个连接会话。Session 对象具有自己的状态，包括 cookie、header 等信息，并且可以在多个请求之间保持会话的一致性。在 Session 对象中，可以设置连接超时来控制请求的等待时间，并可以通过异常处理来处理超时错误。

一、创建 Session 对象

要使用 Session 对象发送请求，首先需要创建一个 Session 对象。可以使用以下方式来创建 Session 对象：

import requests

s = requests.session()

二、设置连接超时

Session 对象的请求超时时间可以通过设置 timeout 参数来控制，单位为秒。timeout 参数接受一个浮点数或者一个 requests.Timeout 对象，可以设置为一个数值，也可以设置为一个包含 connect 和 read 两个字段的字典，分别指定连接超时和读取超时。下面是几种常见的超时设置方式：

1. 设置全局超时：

s = requests.session()
s.timeout = 10  # 全局超时为10秒

2. 设置单个请求的超时：

s = requests.session()
r = s.get('https://www.example.com', timeout=5)  # 单个请求超时为5秒

3. 分别设置连接超时和读取超时：

s = requests.session()
s.timeout = requests.Timeout(connect=5, read=10)  # 连接超时为5秒，读取超时为10秒

4. 使用 with 语句设置超时：

s = requests.session()
with s as session:
    session.timeout = 5  # 会话中全部请求的超时为5秒
    r1 = session.get('https://www.example.com')
    r2 = session.post('https://www.example.com', timeout=10)

三、使用示例

下面是一个完整的示例，演示了如何使用 Session 对象设置连接超时并发送请求：

import requests

s = requests.session()
s.timeout = 5  # 设置超时为5秒

try:
    r = s.get('https://www.example.com')
    r.raise_for_status()  # 如果请求出错，抛出异常
    print(r.text)
except requests.exceptions.RequestException as e:
    print('请求出错:', e)

这个示例中从 "https://www.example.com" 发送一个 GET 请求，并设置超时时间为 5 秒。如果请求成功，则打印请求返回的内容；如果请求出错，则打印错误信息。

总结

Session 对象是 requests 库提供的一个很有用的功能，可以方便地管理和维护一个会话。通过设置连接超时，可以控制请求的等待时间，并能够处理超时错误。使用 Session 对象可以提高请求的效率和一致性，并方便地处理异常情况。