encode/httpx 项目中的 HTTP/2 支持详解

encode/httpx 项目中的 HTTP/2 支持详解

httpx A next generation HTTP client for Python. 🦋 项目地址: https://gitcode.com/gh_mirrors/ht/httpx

HTTP/2 协议概述

HTTP/2 是 HTTP 协议的重大革新版本，它在保持 HTTP/1.1 核心语义不变的前提下，通过多项技术改进显著提升了传输效率。与基于文本格式的 HTTP/1.1 不同，HTTP/2 采用二进制格式传输数据，这种设计带来了几个关键优势：

1. 多路复用：允许在单个 TCP 连接上同时传输多个请求和响应，彻底解决了 HTTP/1.1 中的队头阻塞问题
2. 头部压缩：使用 HPACK 算法对 HTTP 头部进行高效压缩，减少了冗余数据传输
3. 流优先级：支持为不同请求设置优先级，优化关键资源的加载顺序
4. 服务器推送：服务端可以主动向客户端推送资源，减少额外的请求往返

encode/httpx 的 HTTP/2 实现特点

encode/httpx 作为一个现代化的 HTTP 客户端库，提供了对 HTTP/2 协议的完整支持，但出于稳定性考虑，默认仍使用 HTTP/1.1。这是因为：

• HTTP/1.1 经过长期实践验证，具有极高的稳定性
• 在某些特殊场景下，HTTP/1.1 的实现可能更为可靠
• 未来版本可能会将 HTTP/2 设为默认选项

启用 HTTP/2 支持

安装必要依赖

要使用 HTTP/2 功能，需要先安装额外的依赖包：

pip install httpx[http2]

这个命令会安装 HTTP/2 实现所需的所有依赖项，包括 hyper-h2 等核心组件。

客户端配置

创建支持 HTTP/2 的客户端有两种常用方式：

1. 常规实例化：

client = httpx.AsyncClient(http2=True)

2. 上下文管理器方式（推荐）：

async with httpx.AsyncClient(http2=True) as client:
    # 在此代码块中使用client
    # 退出时自动关闭连接

上下文管理器方式能确保所有 HTTP 连接被正确管理，避免资源泄漏。

客户端类型选择

encode/httpx 同时支持同步和异步客户端：

• Client：同步客户端
• AsyncClient：异步客户端

在需要处理大量并发请求的场景下，异步客户端配合 HTTP/2 能发挥最佳性能。

协议版本检测

启用 HTTP/2 支持不意味着所有请求都会使用 HTTP/2，这取决于服务端是否支持。客户端会自动协商使用双方都支持的最高版本协议。

可以通过检查响应对象的 .http_version 属性确定实际使用的协议版本：

response = await client.get("https://example.com")
print(response.http_version)  # 输出可能是 "HTTP/1.1" 或 "HTTP/2"

性能优化建议

1. 高并发场景：当需要同时发起大量请求时，HTTP/2 的多路复用特性可以显著减少连接建立开销
2. 小文件请求：对于大量小文件请求，HTTP/2 的头部压缩能有效降低带宽消耗
3. 关键资源优先：利用 HTTP/2 的流优先级特性优化关键资源的加载顺序

注意事项

1. 某些老旧服务器可能不完全支持 HTTP/2 的所有特性
2. 在调试时，二进制格式的 HTTP/2 流量不如 HTTP/1.1 的文本格式直观
3. 某些特殊场景下可能需要回退到 HTTP/1.1

通过合理配置 encode/httpx 的 HTTP/2 支持，开发者可以在兼容现有服务的同时，享受现代协议带来的性能提升。

httpx A next generation HTTP client for Python. 🦋 项目地址: https://gitcode.com/gh_mirrors/ht/httpx