Python / 技术文章
Requests、HTTPX、aiohttp 怎么选
当 Python 项目要发 HTTP 请求时,Requests、HTTPX 和 aiohttp 都能完成 GET、POST,但同步/异步模型、协议能力和资源管理方式不同。适合脚本、后端服务和异步任务开发者,读完可按项目约束完成选型。
先按运行模型排除不合适的库
如果项目主体是同步代码,例如一次性脚本、数据清洗任务、运维工具或传统同步 Web 应用,Requests 通常是最低成本的选择。它的 API 简单,不需要为了少量 HTTP 调用引入事件循环。
需要连续访问同一服务时,使用 Session 保持 Cookie 并复用连接,而不是在循环里只调用顶层请求函数。这样能保留同步代码的简单性,也避免重复建立 TCP/TLS 连接。
如果代码已经由 async def 驱动,例如 FastAPI、Starlette、异步任务消费者或需要同时等待大量外部接口,优先在 HTTPX 的 AsyncClient 与 aiohttp 的 ClientSession 之间选择。
HTTPX 同时保留同步和异步 API,适合一套代码库里两种模型并存;aiohttp 更贴近 asyncio 生态,并原生提供 WebSocket 客户端与服务端能力。

三个库的关键差异不在请求语法
三者的 get()、请求头、查询参数和 JSON 处理都不难,真正需要比较的是运行模型、连接生命周期和协议能力。选型时可以先看下面几项,而不是只比较“哪一个写起来更短”。
| 维度 | Requests | HTTPX | aiohttp |
|---|---|---|---|
| 主要模型 | 同步 | 同步 + 异步 | asyncio 异步 |
| 推荐复用对象 | requests.Session |
httpx.Client / httpx.AsyncClient |
aiohttp.ClientSession |
| HTTP/2 | 不作为原生能力 | 可选启用 | 不作为主要选型优势 |
| WebSocket | 需其他库 | 需其他 WebSocket 实现配合 | 客户端与服务端均可直接使用 |
| 适合的迁移路径 | 已有同步代码继续使用 | 从同步逐步过渡到异步较自然 | 已经全面采用 asyncio 时更顺手 |
Requests 的一个容易忽略的点是:不传 timeout 时不会自动替你设置请求超时。HTTPX 自带默认超时策略,但生产代码仍应按接口 SLA 调整。
aiohttp 也应通过 ClientTimeout 明确总超时、建连和读取上限。真正上线时,超时策略比库名更影响故障恢复速度。
用同一个本地端点跑一遍
下面的示例不依赖公网服务。程序先在随机本地端口启动一个只返回 {"ok": true} 的 HTTP 服务,再让三个客户端请求同一地址。运行前需要在当前 Python 环境中安装 Requests、HTTPX 和 aiohttp。
import asyncio
import json
import threading
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
import aiohttp
import httpx
import requests
class HealthHandler(BaseHTTPRequestHandler):
def do_GET(self):
payload = json.dumps({"ok": True}).encode("utf-8")
self.send_response(200)
self.send_header("Content-Type", "application/json")
self.send_header("Content-Length", str(len(payload)))
self.end_headers()
self.wfile.write(payload)
def log_message(self, format, *args):
# 屏蔽本地测试服务器日志,让输出只保留三种客户端结果。
return
def start_server():
server = ThreadingHTTPServer(("127.0.0.1", 0), HealthHandler)
thread = threading.Thread(target=server.serve_forever, daemon=True)
thread.start()
return server
async def main():
server = start_server()
url = f"http://127.0.0.1:{server.server_port}/health"
try:
# Requests 使用 Session 复用连接,并显式设置连接/读取超时。
with requests.Session() as session:
response = session.get(url, timeout=(3, 10))
print("requests", response.status_code, response.json()["ok"])
with httpx.Client(timeout=httpx.Timeout(10.0, connect=3.0)) as client:
response = client.get(url)
print("httpx", response.status_code, response.json()["ok"])
timeout = aiohttp.ClientTimeout(total=10, sock_connect=3, sock_read=10)
async with aiohttp.ClientSession(timeout=timeout) as session:
async with session.get(url) as response:
data = await response.json()
print("aiohttp", response.status, data["ok"])
finally:
server.shutdown()
server.server_close()
asyncio.run(main())预期输出:
requests 200 True
httpx 200 True
aiohttp 200 True这个结果说明“能不能发请求”不是区分点。三个库都能稳定完成一次普通 HTTP 调用,选型差异要到事件循环、并发量、协议需求以及客户端生命周期里才会显现。
连接池和超时比单次性能更值得先管
生产代码里最常见的浪费,是每发一次请求就新建一次客户端。Requests 应复用 Session,HTTPX 应复用 Client 或 AsyncClient,aiohttp 通常让一个 ClientSession 覆盖应用的一段生命周期。
这些对象承担连接池职责。把它们放在请求热路径外复用,才能利用 Keep-Alive,减少重复 TCP/TLS 建连,也能让连接上限与池等待超时真正起作用。
超时可以先从一组保守值起步,再结合接口 P95、P99 延迟调整。例如普通内部 API 可先尝试连接 3 秒、读取 10 秒。
Requests 可使用 timeout=(3, 10);HTTPX 可使用 httpx.Timeout(10.0, connect=3.0);aiohttp 可设置 ClientTimeout(total=15, sock_connect=3, sock_read=10)。这些值只是起点,目标是把等待时间变成明确的失败边界。
并发控制不要只靠客户端连接池兜底。一次创建几千个协程去打同一个上游,仍可能耗尽文件描述符、连接池容量,或者触发对方限流。
异步项目通常还需要配合 asyncio.Semaphore、队列或业务级限流,把并发上限控制在经过压测的范围内。连接池解决连接复用,并不等于自动解决业务并发。
按项目场景做最终选择
选择 Requests 的典型场景,是同步脚本、管理命令、低到中等并发的后端任务,以及已经稳定运行的大量同步代码。没有异步需求时,继续使用成熟、简单的同步模型通常比为了“新”而迁移更划算。
选择 HTTPX 的典型场景,是项目既有同步代码又逐步引入 asyncio,或者明确需要 HTTP/2,并希望同步与异步客户端保持相近的调用方式。
FastAPI、Starlette 等 ASGI 项目需要向外调用 HTTP 服务时,AsyncClient 也很自然;测试时还可以通过 ASGI Transport 直接调用应用,减少真实网络依赖。
选择 aiohttp 的典型场景,是项目已经全面围绕 asyncio 构建,需要长期维持较多并发连接,或者同时使用 HTTP 客户端、WebSocket、异步 HTTP 服务端等能力。
此时统一使用 aiohttp 可以减少跨库切换,但团队需要熟悉事件循环、异步资源关闭和并发控制。若项目只偶尔发几个请求,这些额外复杂度通常没有收益。
最终可以把规则压缩成三句话:纯同步且需求简单,先选 Requests;同步与异步并存或需要 HTTP/2,优先看 HTTPX;已经是 asyncio 技术栈并且重度使用异步网络能力,重点看 aiohttp。已有项目如果没有明确痛点,不必仅为了换库而迁移。