httpx.AsyncClient能直接替代aiohttp.ClientSession，因二者均基于asyncio且接口语义相似；但httpx设计更贴近requests，无需嵌套async with、默认支持HTTP/2与连接复用，且AsyncClient实例本身即可发请求，不需额外session上下文。
为什么 httpx.AsyncClient 能直接替代 aiohttp.ClientSession
因为两者都基于 asyncio，且都提供类似语义的异步请求接口。但 httpx 的设计更贴近 requests，不用手动处理 response.read() 或 response.json() 的 await 链，也默认支持 HTTP/2 和连接复用。关键区别在于：它把 session 管理和请求方法封装得更扁平——AsyncClient 实例本身就能发请求，不需要像 aiohttp 那样必须 async with session.get(...) 套两层上下文。
常见错误是照搬 aiohttp 的写法，比如在 httpx 里还写 async with client as session: ——这会报 AttributeError: __aenter__，因为 AsyncClient 没有实现该协议；正确做法是直接 await client.get(...)，或显式 async with client:（仅用于生命周期管理，非请求必需）。
httpx.AsyncClient 的超时与重试配置怎么设才不踩坑
httpx 默认超时是 5 秒，且对 connect、read、write 分开控制，而 aiohttp 默认只设总 timeout。若你原来用 aiohttp.ClientTimeout(total=30)，直接换成 httpx.AsyncClient(timeout=30) 会导致 read 超时仍为 5 秒，后端响应慢时容易误判失败。
- 推荐显式配置：
timeout=httpx.Timeout(30.0, connect=10.0, read=25.0, write=5.0) - 重试需额外装
httpx[http2]并配合httpx.AsyncHTTPTransport，不能只靠AsyncClient(retries=3)（该参数不存在） - 若服务端返回 429 或 5xx，要自己用
tenacity或手动 while 循环重试，httpx不内置重试逻辑
如何安全复用 AsyncClient 实例而不引发连接泄漏
AsyncClient 是线程不安全的，但可在单个 event loop 中跨协程复用——这点和 aiohttp.ClientSession 一致。问题常出在生命周期管理上：有人在每次请求都新建 client，导致大量 TIME_WAIT 连接；也有人在模块顶层创建全局 client，却忘了关闭，最终耗尽文件描述符。
立即学习“Python免费学习笔记（深入）”；
- 最佳实践：在应用启动时创建一次
AsyncClient，通过依赖注入或全局变量传递；关机前调用await client.aclose() - 避免在函数内
async with httpx.AsyncClient() as client:包裹单次请求——开销大，且无法复用连接池 - 若用 FastAPI，建议在
lifespan事件中管理 client 的生命周期，而不是靠Depends每次 new
POST 表单、JSON、文件上传的写法差异在哪
httpx 把 data、json、files 参数做了明确分离，不像 aiohttp 有时要手动构造 FormData 或设置 Content-Type 头。但注意：传 json=... 会自动加 application/json 头并序列化，而 data=... 默认是 application/x-www-form-urlencoded，不会自动编码字典。
- 发 JSON：
await client.post(url, json={"key": "value"}) - 发表单：
await client.post(url, data={"username": "a", "pwd": "b"}) - 传文件：
await client.post(url, files={"file": open("a.txt", "rb")})，注意文件对象需保持打开状态直到请求完成 - 别混用
json和data，否则httpx会静默忽略json
连接复用、超时粒度、client 生命周期——这三个点没对齐，替换后反而比原来更不稳定。
