Go net/http Server.Protocols 如何按服务启用 HTTP/1 与 HTTP/2：协议集与回归检查

把 Go 服务升级到 1.24 后，协议策略不必再藏在默认行为里。对外 TLS 入口如果只想保留 HTTP/1，或要明确接受 HTTP/1 与 HTTP/2，可以直接设置 http.Server.Protocols。关键点是：Protocols 的零值是空集合，而 Server.Protocols 为 nil 时才走 net/http 的默认协议策略。

先把协议选择从默认值变成显式配置

实际开发中你可以直接通过配置 `Server.Protocols` 字段指定当前服务支持的 HTTP 协议集合，既能单独开启 HTTP/1.x 兼容旧客户端，也能同时启用 TLS 下的 HTTP/2，还能搭配自定义协议检查逻辑做版本回归校验，避免后续依赖改动导致协议支持异常。

老服务最容易踩的坑，是先写了 srv.Protocols = new(http.Protocols)，却没有再调用任何 Set 方法。此时指针不再是 nil，但它指向的是空协议集，服务并不会保留原来的默认组合。对一个同时服务旧客户端和现代浏览器的 TLS 入口，更稳妥的最小配置是同时放入 HTTP/1 和 HTTP/2。

package main

import (
    "log"
    "net/http"
)

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

    log.Fatal(srv.ListenAndServeTLS("cert.pem", "key.pem"))
}

这里的 ListenAndServeTLS 提供 TLS 入口；srv.Protocols 保存允许集合；两个 Set 调用分别把协议放入集合。配置意图一眼可见，也不会因为后续自定义 TLSNextProto 或改动 Transport 而误以为服务器仍沿用旧默认。

HTTP/1、HTTP/2 与明文 HTTP/2 不是同一个开关

SetHTTP1(true) 对应 HTTP/1.0 与 HTTP/1.1；SetHTTP2(true) 对应 TLS 连接上的 HTTP/2。它们适合绝大多数公网 HTTPS 服务。若要在未加密端口上接受 HTTP/2，需要单独调用 SetUnencryptedHTTP2(true)。

后者使用的是 HTTP/2 prior knowledge：客户端一开始就按 HTTP/2 发起连接。它不是把普通 HTTP/1 请求“升级”为 HTTP/2，也不是给公网 80 端口随手加一个性能选项。只有反向代理到应用、内网 gRPC 兼容链路等已经约定该协议的场景，才应把它加入 srv.Protocols。

把协议策略放进回归检查

不要只看服务能启动。先用一个 HTTPS 测试入口发起请求，再读取 resp.Proto；同一服务至少应覆盖一个 HTTP/1 客户端和一个允许 HTTP/2 的客户端。测试的重点不是硬编码某个实现细节，而是确认你的 srv.Protocols 与部署目标一致。

func TestProtocolSet(t *testing.T) {
    p := new(http.Protocols)
    p.SetHTTP1(true)
    p.SetHTTP2(true)

    if !p.HTTP1() || !p.HTTP2() {
        t.Fatal("expected HTTP/1 and HTTP/2")
    }
    if p.UnencryptedHTTP2() {
        t.Fatal("unencrypted HTTP/2 was not requested")
    }
}

这段检查把 SetHTTP1、SetHTTP2 的写入结果与 HTTP1、HTTP2 的读取结果绑定起来。若服务刻意关闭 HTTP/2，就把第二个期望改成 false，并在集成环境确认客户端发生的是预期降级，而不是握手失败。

上线前的四项检查

1. 确认运行时 Go 版本不低于 1.24；Protocols 是该版本新增 API。
2. 确认 srv.Protocols 为 nil 还是显式集合，避免空集合意外收紧入口。
3. 对 TLS 服务分别验证 HTTP/1 与 HTTP/2；对明文 HTTP/2 再验证 prior knowledge 客户端。
4. 若设置过 TLSNextProto 或自定义 Transport，把协议期望写成测试，而不要依赖默认推断。

相关问答

不设置 Server.Protocols 会怎样？

字段为 nil 时，net/http 通常按默认策略处理 HTTP/1 和 HTTP/2；自定义 TLS 相关配置可能影响默认范围，因此生产配置仍建议明确测试。

SetHTTP2(true) 能开启明文 h2c 吗？

不能。TLS HTTP/2 与明文 HTTP/2 是不同成员；明文场景要使用 SetUnencryptedHTTP2，并确保客户端使用 prior knowledge。

为什么 new(http.Protocols) 后服务不通？

因为零值 Protocols 是空集合。创建后需要至少调用 SetHTTP1 或 SetHTTP2，才能把允许协议加入集合。

收尾

把 Server.Protocols 当成服务边界的一部分：先写出允许集合，再用客户端协议和单元测试核对结果。这样升级 Go、调整 TLS 配置或接入代理时，协议行为才不会靠猜。