0

0

aiohttp 如何设置全局超时 + 连接池大小

舞夢輝影

舞夢輝影

发布时间:2026-01-23 18:50:04

|

120人浏览过

|

来源于php中文网

原创

需在每次创建ClientSession时显式传入aiohttp.ClientTimeout和TCPConnector:timeout控制DNS、连接、读写全周期超时,推荐显式设total/connect/sock_read;connector管理连接池,需设limit和limit_per_host防止单域名占满,并复用session对象。

aiohttp 如何设置全局超时 + 连接池大小

如何用 aiohttp.ClientTimeout 设置全局请求超时

全局超时不是靠环境变量或全局配置实现的,必须在每次创建 aiohttp.ClientSession 时显式传入 timeout 参数。它控制整个请求生命周期(DNS 解析、连接、读写),不是仅限于某一个阶段。

常见错误是只设 timeout=10 却没意识到这其实是 ClientTimeout(total=10),而默认的 connectsock_read 等子超时继承自 total,容易在高延迟网络下被误触发。

  • 推荐显式构造: timeout=aiohttp.ClientTimeout(total=30, connect=10, sock_read=20)
  • 若想彻底禁用超时(不建议),用 timeout=None,但会失去对卡死连接的保护
  • total 必须 ≥ 所有子超时之和,否则初始化会报 ValueError: Total timeout cannot be less than connect timeout

如何通过 aiohttp.TCPConnector 控制连接池大小

连接池由 TCPConnector 管理,默认最多 100 个空闲连接、总共不限(limit=100, limit_per_host=0),但实际并发请求数受 limitlimit_per_host 共同约束。

很多人以为调大 limit 就能提升吞吐,却忽略了 DNS 缓存、服务端连接限制、本地文件描述符上限等隐性瓶颈。

  • 设总连接数上限:connector = aiohttp.TCPConnector(limit=50)
  • 防止单域名占满池子:limit_per_host=10(尤其爬多域名时必加)
  • 启用连接复用需设 keepalive_timeout=30(默认 15s),太短会导致频繁重连
  • 注意:连接池对象必须复用,不要每次请求都新建 ClientSession(connector=...)

把超时和连接池一起配进 ClientSession

二者必须同时配置才生效,且 connector 和 timeout 都是一次性绑定到 session 的——session 关闭后所有设置失效。

通义千问
通义千问

阿里巴巴推出的全能AI助手

下载
import aiohttp

timeout = aiohttp.ClientTimeout(total=30, connect=10, sock_read=20) connector = aiohttp.TCPConnector( limit=50, limit_per_host=10, keepalive_timeout=30, pool_limit=50, # 已废弃,用 limit 替代 )

async with aiohttp.ClientSession( timeout=timeout, connector=connector ) as session: async with session.get("https://www.php.cn/link/85c19375f0c12c6793bf66b4e2666dc4") as resp: print(await resp.text())

漏掉 timeout=...connector=... 中任意一个,对应功能就不起作用;用完记得 await session.close() 或用 async with,否则连接不会释放。

为什么有时设了 limit_per_host=5 还是发了 20 个并发请求?

因为 limit_per_host 只限制「同一 host」的并发连接数,但如果你请求的是 https://api1.example.comhttps://api2.example.comhttps://www.example.com,它们被视为不同 host,各自独立计数。

更隐蔽的问题是:HTTP/2 或 HTTPS 的 SNI 主机名解析可能让看似相同的域名被拆成多个连接组;某些代理或负载均衡器也会插入额外跳转,导致 host 判断失准。

  • 调试时可打印 session.connector._conns(非公开属性,仅用于排查)观察当前各 host 的活跃连接数
  • curl -v https://host 看实际响应头中的 Server 和重定向目标,确认是否真为同一 host
  • 如需严格控并发,建议上层加 asyncio.Semaphore(5),比依赖 connector 更可靠

连接池和超时参数看着简单,但组合使用时相互影响明显——比如 keepalive_timeout 太短会让连接提前关闭,导致后续请求被迫走新连接,进而触发 connect 超时;这些细节不验证就上线,压测时才暴露。

相关专题

更多
Sass和less的区别
Sass和less的区别

Sass和less的区别有语法差异、变量和混合器的定义方式、导入方式、运算符的支持、扩展性等。本专题为大家提供Sass和less相关的文章、下载、课程内容,供大家免费下载体验。

202

2023.10.12

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

314

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

747

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

88

2025.08.19

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

438

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

175

2023.10.30

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

415

2023.11.14

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel 5.8 中文文档手册
Laravel 5.8 中文文档手册

共74课时 | 86.6万人学习

SESSION实现登录与验证
SESSION实现登录与验证

共10课时 | 9.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号