aiohttp

docs.aiohttp.org官网已核对

Python 的 asyncio 异步 HTTP 库,同一套代码提供客户端与服务器,内置 WebSocket、中间件和可插拔路由,适合已用 asyncio 的开发者写高并发爬虫或异步 Web 后端。

打开官网替代品 5 个 本站 11 月 21 日 实测可以打开
最近 4 次实测

4 次可以打开平均 3.3 秒

本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。
docs.aiohttp.orgaiohttp 首页截图

docs.aiohttp.org 首页 · 本站实拍 · 点开看大图

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 标签。

常见问题

aiohttp 收费吗?
aiohttp 免费使用。Apache 2 许可,免费使用。
用 aiohttp 要登录吗?
不用登录就能用。

替代品全部 5 个,带对比表 →

替代品 5打开官网