HTTP 与 Web 标准 / 系统课时
Alt-Svc 如何发现 HTTP/3 服务
Alt-Svc 如何发现 HTTP/3 服务
Alt-Svc 解决的不是“在现有连接里切换协议”,而是告诉客户端:同一个源还有另一个可用的网络端点。对 HTTP/3 来说,它常用于让已经通过 HTTP/2 收到响应的客户端发现 QUIC 服务,并在后续请求中尝试建立新的 HTTP/3 连接。
学习目标
- 理解
Alt-Svc响应头如何声明 HTTP/3 端点 - 能跟踪客户端从 HTTP/2 发现到 HTTP/3 建连的完整链路
- 能定位“看到了 Alt-Svc 但仍没有切到 HTTP/3”的常见原因
Alt-Svc 描述的是替代服务
典型响应头如下:
Alt-Svc: h3=":443"; ma=86400其中 h3 表示替代服务支持 HTTP/3,:443 表示仍使用当前源的主机名但改走 443 端口,ma 是这条替代服务信息可缓存的最长秒数。它并不要求当前响应本身由 HTTP/3 返回,也不会把现有 HTTP/2 连接原地变成 QUIC。
客户端通常先通过 TCP/TLS 拿到一个 HTTP/2 响应,读取并缓存 Alt-Svc;随后另起 QUIC 连接,在 QUIC 内的 TLS 1.3 握手中通过 ALPN 选择 h3。成功后,后续请求才可能复用这条 HTTP/3 连接。

先确认响应里是否真的有 Alt-Svc
可以用支持 HTTP/2 的 curl 请求自己的站点,并只查看响应头。把 HOST 替换为已经配置 HTTP/3 的域名。
HOST="<HOST>"
curl -sS --http2 -I "https://${HOST}/" | grep -i "^alt-svc:"预期结果是在站点确实发布 HTTP/3 替代服务时看到类似下面的头部;ma 的实际值可能不同:
alt-svc: h3=":443"; ma=<SECONDS>如果没有任何输出,说明当前响应没有可见的 Alt-Svc。此时应检查它是否被 CDN、反向代理或网关删除,或者 HTTP/3 仅在某一层启用但没有向客户端发布替代服务信息。
看到头部为什么仍可能停留在 HTTP/2
Alt-Svc 只是“可以尝试”的声明,不是强制切换指令。客户端还要成功完成 DNS、UDP 可达性、QUIC 握手、证书校验和 h3 的 ALPN 协商。任何一步失败,都可以继续使用原来的 HTTP/2 连接而不影响业务请求。
常见问题包括 UDP 443 被防火墙或安全组拦截、QUIC 监听端口未开放、证书覆盖的主机名不匹配,以及客户端实现没有启用 HTTP/3。还有一种容易误判的情况:首次请求刚收到 Alt-Svc 时,当前请求已经通过 HTTP/2 完成,通常要看后续连接是否尝试 HTTP/3。
缓存会影响复现结果
ma 让客户端可以在一段时间内记住替代服务,因此第二次访问与第一次访问的行为可能不同。浏览器或命令行客户端还可能保存 Alt-Svc 缓存,使你即使暂时移除响应头,客户端仍继续尝试旧的 HTTP/3 端点。
做故障复现时,应明确区分“首次发现”和“已有缓存”两个场景。首次发现用于验证 HTTP/2 响应是否正确发布 Alt-Svc,已有缓存则用于验证客户端能否直接尝试 QUIC。这样才能判断问题究竟出在发现、缓存,还是 HTTP/3 建连阶段。
Alt-Svc 的核心作用是提供替代服务地址;真正的 HTTP/3 成功仍要由后续 QUIC 连接完成。把这两步分开观察,才能准确定位客户端为何没有从 HTTP/2 走到 HTTP/3。