Go http.Protocols 如何显式选择 HTTP/1 与 HTTP/2：SetHTTP1、SetHTTP2 和 ALPN 边界

服务端刚接入一层 TLS 终止代理，客户端的协议协商就变得不再透明：有的请求走 HTTP/2，有的旧客户端仍只能走 HTTP/1.1。Go 1.24 把这件事收进了 net/http 的 http.Protocols，可以在 http.Server 和 http.Transport 上明确声明允许的协议集合。

需要固定协议时，不要只看 URL 是否是 HTTPS；先给 Server 或 Transport 配置一个非空的 http.Protocols，再用 TLS/ALPN 和客户端兼容性检查实际边界。

先把“支持协议”和“实际协商”分开

http.Protocols 是一组协议能力，不是某次请求的结果。它包含 HTTP/1、TLS 上的 HTTP/2，以及可选的明文 HTTP/2。HTTP1()、HTTP2() 和 UnencryptedHTTP2() 只能告诉你集合里有什么，不能证明某个连接已经使用了对应协议。

服务端只允许 HTTP/1：配置 Server.Protocols

如果某个 TLS 入口必须保持旧客户端兼容，或者需要先排除 HTTP/2 的影响，可以给服务端一个只包含 HTTP/1 的集合。关键是先分配 Protocols，再调用设置方法；直接使用零值会得到空集合。

srv := &http.Server{Addr: ":8443"}
srv.Protocols = new(http.Protocols)
srv.Protocols.SetHTTP1(true)

// 证书和私钥由部署环境提供
err := srv.ListenAndServeTLS("cert.pem", "key.pem")
if err != nil && !errors.Is(err, http.ErrServerClosed) {
    log.Fatal(err)
}

这里的“只允许”来自集合里没有打开 HTTP2，并不意味着 TLS 被跳过。客户端仍然可以通过 HTTPS 连接，只是服务端声明的协议集合不包含 HTTP/2。

客户端同时保留 HTTP/1 和 HTTP/2

客户端的配置落在 http.Transport。复制默认 Transport 后再设置协议集合，能避免丢掉默认的代理、连接池和 TLS 行为。保留两个协议时，TLS 连接会通过 ALPN 在双方能力交集里选择。

base := http.DefaultTransport.(*http.Transport).Clone()
base.Protocols = new(http.Protocols)
base.Protocols.SetHTTP1(true)
base.Protocols.SetHTTP2(true)

client := &http.Client{Transport: base}
resp, err := client.Get("https://example.com/health")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

ALPN 为什么会让“打开 HTTP/2”仍然看不到 HTTP/2

HTTP/2 的这条配置表示 TLS 上的 HTTP/2。服务端证书、TLS 终止位置、代理转发方式和客户端能力都会影响 ALPN；如果中间代理已经结束 TLS，Go 客户端看到的可能只是代理提供的协议。排查时先确认 TLS 是否由这条 Go 连接建立，再看服务端和 Transport 的协议集合。

另一个容易误判的点是明文 HTTP/2。它对应 SetUnencryptedHTTP2(true)，和 SetHTTP2(true) 不是同一件事。除非明确控制了双方和网络边界，不要为了“看到 h2”就把明文协议打开。

配置后的检查顺序

把排查拆成三层，能避免把配置问题误判成网络问题：

• 集合层：调用 HTTP1()、HTTP2() 检查目标能力是否真的被加入。
• 连接层：确认 TLS 是否在当前连接上建立，代理是否改变了终止位置。
• 协商层：查看请求实际使用的协议，并将它与双方集合的交集比较。

不要只依据“请求成功”下结论。HTTP/1.1 和 HTTP/2 都可以返回 200，状态码并不能说明 ALPN 选择了哪一个协议。

常见问题与边界

Protocols 的零值能直接交给 Server 吗？

零值是空集合。需要明确限制协议时，先创建 new(http.Protocols)，再按目标调用设置方法。

SetHTTP2(true) 会强制所有请求使用 HTTP/2 吗？

不会。它声明 TLS 上的 HTTP/2 能力，最终还要看 TLS、ALPN、对端能力和中间代理。

HTTP/1 和 HTTP/2 可以同时打开吗？

可以。客户端示例通常同时打开两者，让协商选择双方都支持的协议；若要固定单一协议，就只打开对应能力。

明文 HTTP/2 应该用 SetHTTP2(true) 吗？

不是。明文 HTTP/2 对应 SetUnencryptedHTTP2(true)，它和 TLS 上的 HTTP/2 有不同的连接前提。

收尾：把协议选择写成可复查的配置

Go 1.24 的 http.Protocols 解决的是“允许哪些协议”这个配置问题。真正上线前，保留集合检查、TLS 终止位置和 ALPN 结果三份证据；这样即使代理拓扑变化，也能知道是能力声明、协商条件还是观测方式出了偏差。