Hyper
This content is not available in your language yet.
Hyper 是 Rust HTTP 生态的协议引擎：它负责把异步字节流驱动成 HTTP/1 或 HTTP/2 消息与 body stream，但刻意不包办 DNS、连接建立、连接池和具体异步运行时。Axum 等框架在它之上提供路由与业务抽象。
本册问题地图
Section titled “本册问题地图”Hyper 要围绕协议状态机和运行时 IO 的边界来读：
- HTTP/1 为什么是状态机？ 请求行、headers、body、响应和 keep-alive 的合法顺序必须被逐步验证，解析器不能把整个连接当成一段无结构字节。
- Body 为什么是流？ 大响应不必一次性加载到内存，消费者按 poll 获取数据；背压意味着上游只有在下游准备好时继续生产。
- HTTP/2 与 HTTP/1 的关键差别是什么？ HTTP/2 在一条连接上复用多个 stream，并引入独立流控；连接级和 stream 级状态都可能阻塞请求。
- 运行时 IO 如何接入？ Hyper 只依赖 AsyncRead/AsyncWrite 等抽象，具体 reactor、线程模型和唤醒机制由 Tokio 等运行时提供。
- 连接复用何时失效？ 协议错误、响应 body 未消费、服务端关闭和池策略都会让连接无法回收，不能只看 TCP 是否还活着。
| 项 | 值 |
|---|---|
| 仓库 | hyperium/hyper |
| 本地路径 | E:\source\rust\hyper |
| 分支 | master |
| Commit | fca07bd3（2026-08-12） |
| Hyper | 1.11.0，tag v1.11.0 |
| Rust MSRV | 1.63 |
本册源码坐标均基于该 commit。Hyper 1.x 核心只提供单连接 client API；连接池、legacy client 与 Tokio 适配通常由
hyper-util承担，不能再按 Hyper 0.14 的结构寻找Client池。
Async Read/Write -> client/server conn Builder -> HTTP/1 Dispatcher + Conn or HTTP/2 h2 connection -> Service<Request> -> Response<Body> -> frame/data/trailers- 整体架构：协议层、运行时抽象与 Service 边界
- HTTP/1 状态机：parse、dispatch、body framing、flush 与 keep-alive
- HTTP/2 与 h2：stream 并发、流控、执行器和 graceful shutdown
- Body 与背压：Frame、Incoming、channel、size hint 与 trailer
- 客户端单连接与连接复用：handshake、SendRequest、driver task 与池化边界
- 运行时与 IO 抽象：Read、Write、Executor、Timer 与升级
- 面试专题：源码级 HTTP 状态机与线上排障题