aiohttp
Python 的 asyncio 异步 HTTP 库,同一套代码提供客户端与服务器,内置 WebSocket、中间件和可插拔路由,适合已用 asyncio 的开发者写高并发爬虫或异步 Web 后端。
4 次可以打开平均 3.3 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。aiohttp 是给 Python 的 asyncio 用的异步 HTTP 库,一套代码里同时提供客户端和服务器两半。写爬虫、调第三方 API 时用它发请求,不必等一个响应回来才发下一个;写 Web 服务时用它起一个异步应用,处理函数是 async 函数。当前版本 3.14.5,用 pip 安装。
主要功能
客户端用 ClientSession 管理连接,配合 async with 发请求、读状态码、响应头和正文。服务器端从 aiohttp.web 拿 Application 和 Response,用 add_routes 注册路由,路径里可以带 {name} 这样的变量,处理函数从 request.match_info 取值。
- 客户端与服务端 WebSocket 都开箱可用,不用自己写回调嵌套
- 服务端支持中间件、信号和可插拔路由
- 客户端也支持中间件,用来统一改请求和响应
- 路由表 RouteTableDef 提供类似 Flask @app.route 的写法,但不绑定应用实例,避免循环导入
安装与依赖
基础安装是 pip install aiohttp,依赖 attrs、multidict、yarl。想加快 DNS 解析可以另装 aiodns,官方推荐装;要支持 brotli 压缩则装 Brotli 或 brotlicffi。一条 pip install aiohttp[speedups] 能把 aiohttp、aiodns 和 Brotli 一起装上。
适合谁
适合已经用 asyncio 写 Python 的开发者:需要高并发抓取或调用接口的,或者想用同一套异步风格写 Web 后端和 WebSocket 服务的。文档里有客户端、服务端、低层 API、测试、部署和 FAQ 各章节,还附了一个投票应用的教程。写代码时建议开 python -X dev,客户端会启用严格解析器,帮助发现格式异常的响应。
许可与维护
项目托管在 GitHub,主要由 Nikolay Kim 和 Andrew Svetlov 编写,Apache 2 许可,可自由使用和修改。废弃的公开 API 至少保留一年半才移除,并会抛 DeprecationWarning。提问可以去 GitHub Discussions、Matrix 或 Stack Overflow 的 aiohttp 标签。
