python中http/2需用httpx(推荐)或hyper,requests不支持;http/3仅httpx异步实验性支持,依赖udp且易fallback,当前生产环境基本无需优先考虑。

HTTP/2 在 Python 中怎么用?现实里几乎没人直接用
Python 标准库 http.client 和 urllib.request 完全不支持 HTTP/2;第三方库如 requests 默认也是 HTTP/1.1,且至今没原生 HTTP/2 支持(v2.32 仍无)。真要发 HTTP/2 请求,得换库:httpx(推荐)或 hyper。
常见错误现象:httpx.Client(http2=True) 报 ProtocolError: Remote server does not support HTTP/2 —— 不是代码错,是服务端没开 HTTP/2(比如 Nginx 没配 http2 on,或 TLS 版本太低)。
-
httpx的 HTTP/2 需显式传http2=True,且底层依赖h2+openssl(OpenSSL ≥ 1.1.1) - HTTP/2 连接复用强,但 Python 进程内并发高时,
httpx.AsyncClient比同步更稳,避免线程阻塞 h2 连接状态机 - 别指望
requests加个参数就切 HTTP/2 —— 它的连接池和状态管理跟 h2 协议不兼容
HTTP/3(QUIC)在 Python 里目前只能算“能跑通”
标准库零支持;httpx 从 v0.27 开始实验性支持 HTTP/3,但需额外装 quart 或 aioquic,且只限异步客户端。同步调用 httpx.Client(http3=True) 直接报错。
典型失败场景:httpx.ConnectError: No route to host 或静默 fallback 到 HTTP/1.1 —— 因为 QUIC 依赖 UDP 端口(默认 443),而很多企业防火墙、NAT 设备会丢弃 UDP 443 流量,连握手都进不去。
立即学习“Python免费学习笔记(深入)”;
- 服务端必须明确开启 HTTP/3(如 Cloudflare、Caddy v2.8+、Nginx QUIC 分支),光配 TLS 不够
-
httpx的 HTTP/3 当前不支持连接复用(每个请求新建 UDP socket),高并发下开销比 HTTP/2 大 - 本地开发调试时,
localhost域名大概率触发 fallback:QUIC 要求证书 Subject Alternative Name 包含域名,自签证书常漏掉
HTTP/2 → HTTP/3 迁移不是升级,是重写网络栈
HTTP/2 基于 TCP,靠 TLS 1.2+/ALPN 协商;HTTP/3 彻底换到 UDP+QUIC,TLS 终止点位置、丢包恢复逻辑、连接迁移机制全不同。Python 生态还没准备好抽象这一层差异。
你不能把 httpx.Client(http2=True) 改成 httpx.Client(http3=True) 就完事——async 必须、超时逻辑要重调、DNS 解析行为变(QUIC 可能用 DoH)、代理支持极弱(httpx 当前不支持 HTTP/3 over SOCKS/HTTPS proxy)。
- HTTP/3 的
Alt-Svc响应头解析由httpx自动处理,但 fallback 到 HTTP/1.1 后不会自动回切,得自己监控response.http_version - 日志和监控工具(如 OpenTelemetry)对 HTTP/3 的 span 标记还不稳定,
http_version字段可能为空或错标 - 单元测试里 mock HTTP/3 几乎不可行:没有轻量级 QUIC server 库可嵌入测试进程
什么时候该认真考虑 HTTP/3?现在基本不用急
除非你的用户大量卡在弱网(高铁、4G 切换)、且服务端已全量启用 HTTP/3(查响应头有没有 alt-svc: h3=),否则收益极小。HTTP/2 的头部压缩、多路复用、服务器推送(虽已被弃用)已覆盖绝大多数优化场景。
Python 项目当前更值得投入的是:确保 TLS 配置合规(禁用 TLS 1.0/1.1)、用 httpx 替代 requests 统一异步/同步接口、监控真实链路的协议分布(Nginx 日志加 $sent_http_alt_svc 和 $server_protocol)。
- CDN 层(Cloudflare、Fastly)开 HTTP/3 对源站透明,Python 源站无需改任何代码
- gRPC over HTTP/3?别试——
grpcio官方不支持,社区方案全是 patch,稳定性无保障 - HTTP/3 的 0-RTT 有重放风险,Python 应用层若依赖首请求带敏感 token,得手动关掉
httpx的http3_0rtt=True
协议切换从来不是改个参数的事。HTTP/3 的 UDP 特性让它在 Python 这种 GIL + 同步 I/O 主导的生态里,天然比 HTTP/2 更难驯服——你得先接受“它随时可能 fallback”,再决定要不要为那 5% 的边缘场景多维护一套逻辑。










