PythonAPI调用超时设置方法详解

在Python调用远程API时，网络延迟或服务无响应极易导致程序长时间挂起甚至崩溃，而合理设置请求超时是保障系统健壮性和响应性的关键实践。本文系统梳理了三种主流HTTP客户端——同步的requests和urllib、异步的aiohttp——各自的超时配置方式：requests支持简洁的单值或元组timeout参数，urllib通过标准库原生timeout选项实现轻量控制，aiohttp则借助ClientTimeout对象提供细粒度的连接、读取等阶段超时管理，并强调异常捕获与显式声明的重要性。无论你是构建稳健的Web服务、编写自动化脚本，还是开发高并发异步应用，掌握这些超时技巧都能让你的API调用更可靠、更高效。

如果您调用远程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)

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

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~