Python HTTP/2 vs HTTP/3 (QUIC) 的迁移评估

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% 的边缘场景多维护一套逻辑。