默认的 httpx.client() 已启用连接池，因底层默认使用 httpcore.syncconnectionpool 并预设合理连接数与超时值，只要复用同一 client 实例（而非每次新建或调用 httpx.get），即可自动复用 tcp 连接（http/1.1 keep-alive 或 http/2 stream）。
为什么默认的 httpx.Client() 就已经启用了连接池
直接用 httpx.Client() 实例发起多次请求时，底层会自动复用 TCP 连接（HTTP/1.1 keep-alive 或 HTTP/2 stream），无需额外配置。这是因为 httpx 默认使用 httpcore.AsyncConnectionPool（异步）或 httpcore.SyncConnectionPool（同步），并预设了合理的连接数与超时值。常见误区是以为要手动“开启”连接池——其实只要不每次请求都新建 Client，复用就已生效。
容易踩的坑：
- 每次发请求都写 httpx.get(...)（即使用顶层函数）：这会为每次调用创建临时 Client，连接无法复用；
- 在循环里反复 with httpx.Client() as client:：退出 with 块时连接池被关闭，复用失效；
- 忘记复用同一个 Client 实例（尤其在 FastAPI 依赖注入或类方法中未缓存）。
limits 参数怎么设才不拖慢并发又不耗尽资源
httpx.Client 的 limits 控制连接池行为，关键字段是 max_connections、max_keepalive_connections 和 keepalive_expiry。它们不是越大越好，需匹配目标服务承载能力和本地文件描述符限制。
-
max_connections=100：同一时间最多打开 100 个新连接（含正在使用的 + 空闲 keep-alive） -
max_keepalive_connections=20：空闲连接池中最多保留 20 个可复用连接；超出部分会被主动关闭 -
keepalive_expiry=60.0：空闲连接最长保留 60 秒，超时后自动清理（避免长连接堆积）
典型调优场景：
- 对内网高 QPS 服务（如 Kubernetes Service）：可设 max_connections=500、max_keepalive_connections=100、keepalive_expiry=120；
- 对外网第三方 API（如 GitHub API）：建议保守些，max_connections=20 即可，避免触发对方限流；
- 异步客户端（AsyncClient）下，过高 max_connections 可能因 Python 3.12 的 asyncio selector 性能瓶颈反而降低吞吐。
HTTP/2 支持对连接复用的实际影响
Python 3.12 中 httpx 默认仍走 HTTP/1.1，即使服务端支持 HTTP/2。必须显式启用：httpx.Client(http2=True)。但要注意：
- 启用后所有请求强制走 HTTP/2（若服务端不支持，则降级失败，抛
httpx.UnsupportedProtocol） - HTTP/2 复用更彻底：单 TCP 连接可并发多路请求，
max_keepalive_connections的意义变小，真正瓶颈常转为max_connections和远程服务器的 SETTINGS 帧限制 - 某些代理或中间件（如旧版 Nginx、某些企业防火墙）会拦截或错误处理 HTTP/2，导致连接卡住或重置，此时需关掉
http2=True并抓包确认
验证是否真走 HTTP/2：response.http_version 返回 'HTTP/2'；也可用 curl -v --http2 https://example.com 对比。
如何安全地在多线程/多协程中复用 Client
httpx.Client（同步）可被多个线程共享，但不能跨线程调用同一个实例的 .aclose()；httpx.AsyncClient（异步）则**必须**每个协程共用同一个实例，且只能由一个协程调用 .aclose()，否则会报 RuntimeError: Event loop is closed。
实操建议：
- 同步场景：全局单例或依赖注入容器中管理 Client 生命周期，用 atexit.register(client.close) 或上下文管理器确保关闭；
- 异步场景（如 FastAPI）：用 lifespan 事件启动时创建 AsyncClient，shutdown 时调用 aclose()，绝不在线程池中传 AsyncClient；
- 避免在 __init__ 里直接初始化 AsyncClient，因为此时 event loop 可能尚未运行（常见于 pytest 异步 fixture 初始化失败）。
连接池状态不可见，但可通过 client._transport._pool._connections（私有属性，仅调试用）粗略观察当前活跃连接数——不过生产环境别依赖它。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
