docs: record HTTP2 mixed soak and Linux flow control acceptance

2026-09-23 10:54:14 +08:00
parent fa2be5e016
commit 84670f7be1
8 changed files with 4098 additions and 10 deletions
--- a/transport/native/HTTP2.md
+++ b/transport/native/HTTP2.md
@@ -4,7 +4,11 @@

 当前已提供独立的 `transport/http2` 实验 Runner。它已经验证 TLS/h2、h2c、本地连接和请求闸门、GOAWAY 排空以及 RST_STREAM 取消；这些结果用于验证生命周期设计，不代表 native 已经启用 HTTP/2。实验 Runner 还覆盖了默认 1 MiB 头部上限、8 MiB 请求体上限、128 路同连接 stream 多路复用，以及 2 MiB 慢读取 body 在窗口耗尽后的恢复。`TestTLSSoak` 默认运行 3 秒，Linux 长测通过 `python3 scripts/verifyHTTP2.py --duration 30m` 启动。

-2026-09-23 已在 Linux amd64 完成单 TLS 连接、128 个 worker 的 30 分钟长测：58,102,476 次请求，0 失败与协议错误，采样 RSS 峰值约 22.6 MiB，退出后连接、活动请求和 FD 回收。测试容器限制为 2 核、2 GiB，测量包含同一进程中的客户端与服务端，见 [报告](../../performance/http2SoakLinux.json)。本次包含慢 Handler 与 64 KiB body；多连接、持续慢客户端及代理 HTTP/2 回源验收仍未完成。
+2026-09-23 已在 Linux amd64 完成单 TLS 连接、128 个 worker 的 30 分钟长测：58,102,476 次请求，0 失败与协议错误，采样 RSS 峰值约 22.6 MiB，退出后连接、活动请求和 FD 回收。测试容器限制为 2 核、2 GiB，测量包含同一进程中的客户端与服务端，见 [报告](../../performance/http2SoakLinux.json)。该场景包含慢 Handler 与 64 KiB body。
+
+同日完成多连接慢客户端混合场景：8 条独立 TLS 连接，每条 14 个普通请求 worker、1 个慢上传 worker、1 个慢下载 worker，持续 30 分钟。256 KiB 上传每 4 KiB 等待 2 ms；8 MiB 下载每次最多读取 64 KiB 后等待 20 ms。共完成 53,191,687 次请求，其中慢上传 106,971 次、慢下载 5,588 次，0 失败与协议错误；每条连接均覆盖三类请求且没有重连。采样 RSS 峰值约 116.6 MiB，包含客户端、服务端与下载缓冲；退出后活动连接/请求归零、goroutine 回到 2、FD 回到 6，释放测试数据并两次 GC 后存活堆约 450 KiB。运行命令为 `python3 scripts/verifyHTTP2.py --scenario mixed --duration 30m`，完整采样见 [混合长测报告](../../performance/http2MixedSoakLinux.json)。8 MiB 下载超过客户端的 stream 初始窗口，需要窗口更新，但不代表耗尽了连接级窗口；后者由下述独立帧测试验证。HTTP/2 回源代理联调仍未完成。
+
+连接级流控及关闭边界测试已通过 Linux amd64 的 HTTP/2 全包 race、vet、build 回归，测试提交、执行命令和原始日志校验值见 [边界回归报告](../../performance/http2FlowControlLinux.json)。

 ## 目标边界

@@ -29,11 +33,11 @@ HTTP/2 版本需要在 native `Stats` 之外至少记录：活动 stream、被
 ## 进入实现前的验收矩阵

 - TLS ALPN：只协商 `h2`，HTTP/1.1 客户端仍由现有 native 路径处理；不支持的 ALPN 在握手前后都不会误入错误解析器。
- 多路复用：一个连接并发至少 128 个 stream，响应和 requestId 不串线，单个慢 stream 不阻塞其他 stream（实验 Runner 已覆盖 128 路同连接 stream）。
- 流控：慢读取、慢写、窗口耗尽和大 body 都能恢复；内存不会随未消费 body 无限增长。实验 Runner 已覆盖 2 MiB 慢读取 body 和请求体上限，以及客户端将 stream 窗口设为零时的大响应阻塞、同连接 204、其他连接带 body 响应、WINDOW_UPDATE 恢复发送和 RST_STREAM 取消回收；连接级窗口耗尽和持续慢客户端混合长测仍需补齐。
- 取消：RST_STREAM、客户端断开、服务关闭分别只影响应受影响的请求，并能在 metrics 中看到回收；当前实验 Runner 已覆盖 RST_STREAM 与服务关闭。
+- 多路复用：一个连接并发至少 128 个 stream，响应和 requestId 不串线，在流与连接级发送额度充足时，单个慢 stream 不阻塞其他可发送 stream（实验 Runner 已覆盖 128 路同连接 stream）。
+- 流控：慢读取、慢写、窗口耗尽和大 body 都能恢复；内存不会随未消费 body 无限增长。实验 Runner 已覆盖 2 MiB 慢读取 body 和请求体上限，以及客户端将 stream 窗口设为零时的大响应阻塞、同连接 204、其他连接带 body 响应、WINDOW_UPDATE 恢复发送和 RST_STREAM 取消回收；连接级独立测试将初始 stream 窗口设为 128 KiB，仅消耗默认 65,535 字节连接窗口，确认暂停与隔离，连接级 WINDOW_UPDATE 后恢复并复用连接；持续慢客户端混合长测也已通过。连接级窗口耗尽时，同连接的其他 DATA 也受该窗口约束，HEADERS 和其他 TCP 连接仍可继续。
+- 取消：RST_STREAM、客户端断开、服务关闭分别只影响应受影响的请求，并能在 metrics 中看到回收；当前实验 Runner 已覆盖 RST_STREAM 与服务关闭，包括客户端零接收窗口造成写阻塞时，关闭超时强制解除写阻塞、取消请求并回收连接。
 - 背压：连接上限、全局 stream 上限、单连接 stream 上限和 header/body 上限均能快速拒绝并自动恢复。实验 Runner 已增加 TLS 未完成握手占满连接槽位时的及时拒绝、握手超时回收及后续正常 HTTPS 请求恢复验收。
 - 代理联调：Nginx/Cloudflare 的 TLS、Keep-Alive、超时、GOAWAY 和优雅发布行为与 HTTP/1.1 回源结果一致。现有 `verifyProxy.py` 检查边缘 HTTP/2 协商与 native HTTP/1.1 TLS 回源，不构成 HTTP/2 上游 GOAWAY/排空的验收依据。
- 长测：Linux amd64 至少 30 分钟 TLS、多连接、多 stream、慢客户端混合场景；要求 0 协议错误、0 请求串线，连接、stream、goroutine 和 FD 在停止后回收。单连接 30 分钟场景已通过，完整混合场景仍待验证。
+- 长测：Linux amd64 至少 30 分钟 TLS、多连接、多 stream、慢客户端混合场景；要求 0 协议错误、0 请求串线，连接、stream、goroutine 和 FD 在停止后回收。单连接场景与 8 连接慢上传/慢下载混合场景均已通过，原始日志与采样分别保存在两个报告中。

 只有上述矩阵完成，才把 `h2` 加入 native 的 TLS ALPN，并考虑把 HTTP/2 作为独立版本能力发布。此前生产环境使用 Nginx/Cloudflare 终止 HTTP/2 后以 HTTP/1.1 回源，或使用支持 HTTP/2 的 `transport/nethttp`。