使用 requests 库可设置 timeout 参数(单值或元组)控制连接和读取超时,超时抛出 Timeout 异常;2. urllib 通过 urlopen 的 timeout 参数设置超时,触发 socket.timeout 异常;3. aiohttp使用 ClientTimeout对象 精细配置 异步 请求超时,需在 Clientsession中显式传入。

如果您调用远程 API接口 时遇到网络延迟或服务器无响应的情况,程序可能会长时间挂起。为了避免这种情况,必须为请求设置超时时间以控制最大等待时长。以下是几种在 python 中设置 API 请求超时的方法。
一、使用 requests 库设置超时
requests 库是 Python 中最常用的 HTTP 客户端之一,支持通过参数直接指定连接和读取超时时间。该方法适用于绝大多数基于 HTTP/https的api 调用。
1、导入 requests 模块 并发 起带超时参数的 GET 请求,timeout 参数可设置为浮点数或元组。
2、若仅传入单个数值,则该值同时用于连接超时和读取超时,例如设置 5 秒超时:
response = requests.get(“https://api.example.com/data”, timeout=5.0)
立即学习“Python 免费学习笔记(深入)”;
3、若需分别设置连接和读取超时,可传递元组形式的(timeout_connect, timeout_read),例如:
response = requests.get(“https://api.example.com/data”, timeout=(3.0, 10.0))
4、当请求超出设定时间仍未完成,将抛出 requests.exceptions.Timeout 异常,可通过try-except 捕获处理。
二、使用 urllib 设置超时
urllib 是 Python标准库 中的 HTTP 请求 工具,无需额外安装即可使用。它允许在创建请求对象时指定超时时间,适合轻量级应用场景。
1、从 urllib.request 模块导入 urlopen 函数,并在调用时添加 timeout 参数。
2、发送请求并设置 5 秒超时:
import urllib.request
with urllib.request.urlopen(“http://api.example.com/data”, timeout=5) as response:
data = response.read()
3、超时触发时会引发 socket.timeout 异常,建议使用 try-except 结构进行异常捕捉。
4、对于需要配置代理或自定义头部的场景,可结合 Request 类与 urlopen 一起使用,并保留 timeout 参数。
三、使用aiohttp 设置异步请求超时
aiohttp 用于执行非阻塞的异步 HTTP 请求,适合高并发场景。其超时控制机制更为精细,可通过 ClientTimeout 对象进行详细配置。
1、安装 aiohttp 库后,导入 aiohttp 和 asyncio 模块,定义异步函数发起请求。
2、创建 ClientTimeout 实例,分别设置 connect 和 sock_read 超时值:
timeout = aiohttp.ClientTimeout(connect=3, sock_read=7)
3、在 aiohttp.ClientSession 中传入 timeout 参数:
async with aiohttp.ClientSession() as session:
async with session.get(“https://api.example.com/data”, timeout=timeout) as resp:
text = await resp.text()
4、未指定 timeout 时默认使用全局默认值,建议显式声明避免意外阻塞。