Python中关于requests库timeout参数的疑问与使用详解

帖子回复：

关于 requests 库的 timeout 参数，核心就两点：连接超时和读取超时。这俩是分开控制的，但用一个参数就能搞定。

1. 基本用法

import requests

# 设置总超时（连接+读取）为5秒
response = requests.get('https://api.example.com', timeout=5)

# 分别设置连接超时2秒，读取超时10秒
response = requests.get('https://api.example.com', timeout=(2, 10))

2. 关键细节

• 连接超时：从发请求到建立连接的时间，包括DNS解析、TCP握手、SSL握手
• 读取超时：连接建立后，等待服务器返回第一个字节的时间
• 超时异常：连接超时抛 ConnectTimeout，读取超时抛 ReadTimeout
• 默认行为：不设置timeout时，requests会一直等待（生产环境千万别这样！）

3. 实际场景示例

import requests
from requests.exceptions import Timeout, ConnectionError

try:
    # 对慢速API：快速失败连接，但允许较长的读取时间
    response = requests.get('https://slow-api.com/data', timeout=(3, 30))
    print("请求成功")
    
except Timeout as e:
    if isinstance(e, requests.exceptions.ConnectTimeout):
        print("连接超时 - 服务器太慢或网络有问题")
    elif isinstance(e, requests.exceptions.ReadTimeout):
        print("读取超时 - 服务器处理请求太慢")
        
except ConnectionError:
    print("连接错误 - 检查网络或URL")

4. 最佳实践

• 永远设置timeout：生产代码必须设置，防止线程/进程被卡死
• 区分内外网：内网服务可以用(2, 5)，外网API建议(3, 10)
• 文件上传下载：读取超时要设长点，比如 timeout=(5, 60)
• Session复用：给Session对象设置默认timeout

session = requests.Session()
session.request = functools.partial(session.request, timeout=(3, 10))

总结：timeout就是你的安全绳，不系就别爬高。