HTTP/2需显式启用并安装h2/hpack依赖，异步客户端配合asyncio.gather实现多路复用，注意header大小限制、连接池复用及Cookie手动管理。
HTTP/2支持需要显式启用且依赖底层库
httpx 默认不启用 HTTP/2，即使服务端支持，请求仍走 HTTP/1.1。必须手动开启 http2=True，且需确保安装了支持 HTTP/2 的底层实现——h2 和 hpack（通常随 httpx[http2] 自动安装）。漏掉这步，httpx.AsyncClient(http2=True) 会静默退回到 HTTP/1.1，你根本收不到错误提示。
验证是否真走 HTTP/2：检查响应对象的 response.http_version 属性，预期值是 "HTTP/2"；或用 Wireshark / mitmproxy 抓包确认帧类型（如 HEADERS、DATA 而非文本型请求行）。
常见错误现象：httpx.ConnectError: [Errno -2] Name or service not known 可能是 DNS 解析失败，但更常因未装 h2 导致初始化失败而掩盖真实原因；建议先运行 python -c "import h2; print(h2.__version__)" 确认依赖就位。
并发请求必须用 AsyncClient + asyncio.gather
httpx 的 HTTP/2 多路复用（multiplexing）只在异步客户端中生效。同步的 httpx.Client 即使设了 http2=True，也仅对单请求启用 HTTP/2，无法复用连接做并发。真正高性能的关键是：一个 httpx.AsyncClient 实例 + 多个协程 + asyncio.gather。
立即学习“Python免费学习笔记（深入）”；
实操建议：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 复用同一个
AsyncClient实例，避免重复建连开销； - 不要在循环里反复
await client.get(...)，要先构造所有协程对象，再一次性await asyncio.gather(*coros)； - 设置合理的
limits，例如httpx.Limits(max_connections=100, max_keepalive_connections=20)，否则默认限制（10 连接）会成为瓶颈； - 注意服务端是否允许 HTTP/2 连接长时间空闲——某些 CDN 或反向代理会在 30 秒后主动关闭连接，导致后续请求触发重连，此时应配
keepalive_expiry=25.0主动提前释放。
HTTP/2下 header 大小和编码有硬性限制
HTTP/2 使用 HPACK 压缩头部，但每个请求的 header block 总大小受对端通告的 SETTINGS_MAX_HEADER_LIST_SIZE 限制（常见默认值为 64KB）。若你塞入超长 Cookie、自定义 token 或大量 query 参数，可能触发 httpx.ProtocolError: Header size exceeded max_header_list_size。
解决方法：
- 用
client.get(url, headers={"User-Agent": "xxx"})显式精简 header，避免继承默认大 header； - 避免在 URL 中拼接过长参数，改用
data=...或json=...发送； - 必要时调大客户端限制（仅当确认服务端支持）：
httpx.AsyncClient(http2=True, limits=httpx.Limits(max_keepalive_connections=10, max_header_list_size=1048576))； - 注意：该限制是 per-request，不是全局；且服务端可动态调整，所以最好在首次连接后读取
client._transport._h2_connection.remote_settings.max_header_list_size（属内部属性，慎用）。
连接池复用与 Cookie 管理需手动干预
HTTP/2 的多路复用意味着多个请求共享一条 TCP 连接，但 httpx.AsyncClient 默认的 Cookie 管理器（httpx.Cookies）是按域名+路径维度缓存，不感知 HTTP/2 连接粒度。如果你并发请求不同子域（如 api.a.com 和 api.b.com），它们不会共用连接，但 cookie 仍可能被错误携带。
关键点：
- 不要依赖全局
client.cookies.set(...)传参，尤其在高并发场景下易出现竞态； - 对需要带认证的请求，显式传
cookies=...字典，或使用httpx.Cookies()实例并调用.set(...)后绑定到单次请求； - 若需跨域名复用连接，得自己维护连接池映射关系（非常规需求，一般不建议）；
- 调试时可用
client._transport._connections（内部属性）查看当前活跃连接数及目标地址，确认复用是否生效。
HTTP/2 的性能优势很实在，但它的“隐式连接复用”和“header 压缩边界”不像 HTTP/1.1 那样直观——很多问题要靠 response.http_version、抓包、或直接 inspect transport 内部状态才能定位。别只盯着并发数，先确认连接真复用了、header 没爆、cookie 没乱塞。
