Python调用API接口如何设置超时时间_Python调用API接口设置请求超时的方法与示例

29次阅读

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

Python 调用 API 接口如何设置超时时间_Python 调用 API 接口设置请求超时的方法与示例

如果您调用远程 API接口 时遇到网络延迟或服务器无响应的情况,程序可能会长时间挂起。为了避免这种情况,必须为请求设置超时时间以控制最大等待时长。以下是几种在 python 中设置 API 请求超时的方法。

一、使用 requests 库设置超时

requests 库是 Python 中最常用的 HTTP 客户端之一,支持通过参数直接指定连接和读取超时时间。该方法适用于绝大多数基于 HTTP/httpsapi 调用

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 参数。

Python 调用 API 接口如何设置超时时间_Python 调用 API 接口设置请求超时的方法与示例

ViiTor 实时翻译

AI 实时多语言翻译专家!强大的语音识别、AR 翻译功能。

Python 调用 API 接口如何设置超时时间_Python 调用 API 接口设置请求超时的方法与示例 116

查看详情 Python 调用 API 接口如何设置超时时间_Python 调用 API 接口设置请求超时的方法与示例

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 时默认使用全局默认值,建议显式声明避免意外阻塞

站长
版权声明:本站原创文章,由 站长 2025-11-09发表,共计1588字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
1a44ec70fbfb7ca70432d56d3e5ef742
text=ZqhQzanResources