Go http.Protocols 怎样分别开启 HTTP/1 和 HTTP/2

Go 的 http.Protocols 用来声明允许使用的协议集合：SetHTTP1(true) 开启 HTTP/1，SetHTTP2(true) 开启 TLS 上的 HTTP/2。把集合赋给 Server.Protocols 或 Transport.Protocols，即可分别配置服务端和客户端。该类型从 Go 1.24 开始提供。

官方文档：https://pkg.go.dev/net/http

先确定协议走在哪种连接上

零值是空集合，因此创建对象以后必须设置所需项目。配置集合声明的是允许范围，不代表每个请求一定使用 HTTP/2；连接对端也必须支持相应协议。

给 TLS 服务明确列出允许协议

下面的独立服务程序同时允许 HTTP/1 和 HTTP/2，监听回环地址，便于先在受控环境使用。准备匹配访问名称的证书和私钥后再启动，证书文件须由部署环境提供，不能把示例文件名当作现成证书。

package main

import (
    "crypto/tls"
    "errors"
    "fmt"
    "log"
    "net/http"
    "time"
)

func main() {
    // 空集合不启用任何协议；逐项声明需要支持的协议。
    allowed := new(http.Protocols)
    allowed.SetHTTP1(true)
    allowed.SetHTTP2(true)
    mux := http.NewServeMux()
    mux.HandleFunc("GET /protocol", func(w http.ResponseWriter, r *http.Request) {
        // 仅记录协议，不把请求凭据写进日志。
        log.Printf("protocol=%s", r.Proto)
        fmt.Fprintln(w, r.Proto)
    })
    srv := &http.Server{
        Addr: "127.0.0.1:9443",
        Handler: mux,
        Protocols: allowed,
        ReadHeaderTimeout: 5 * time.Second,
        IdleTimeout: 60 * time.Second,
        TLSConfig: &tls.Config{MinVersion: tls.VersionTLS12},
    }
    // 使用匹配访问域名且受信任的证书；文件名是示例配置。
    err := srv.ListenAndServeTLS("server-cert.pem", "server-key.pem")
    if err != nil && !errors.Is(err, http.ErrServerClosed) {
        log.Fatal(err)
    }
}

只允许 HTTP/1 时删除 SetHTTP2 那行；只允许 TLS HTTP/2 时删除 SetHTTP1 那行。不要把协议开关与证书校验混为一谈，也不要通过关闭证书校验来处理配置问题。

客户端使用自己的 Transport 配置

服务端允许某协议，不会替调用方修改客户端配置。下面的客户端同样允许 HTTP/1 和 TLS HTTP/2。两个程序分别保存，客户端 URL 要与服务证书名称及信任链一致。

package main

import (
    "log"
    "net/http"
    "time"
)

func main() {
    // 克隆默认Transport，避免修改进程共享的默认对象。
    tr := http.DefaultTransport.(*http.Transport).Clone()
    tr.Protocols = new(http.Protocols)
    tr.Protocols.SetHTTP1(true)
    tr.Protocols.SetHTTP2(true)
    defer tr.CloseIdleConnections()
    cli := &http.Client{Transport: tr, Timeout: 10 * time.Second}
    // 替换为你拥有且证书校验正常的服务地址。
    resp, err := cli.Get("https://localhost:9443/protocol")
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    log.Printf("status=%d protocol=%s", resp.StatusCode, resp.Proto)
}

协议配置在发请求前完成。示例中的请求有整体超时，响应体在使用完毕后关闭；实际业务需要处理响应内容时，应在关闭前按业务要求读取。

明文 HTTP/2 是独立选项

仅设置 SetHTTP2 不会让普通 http:// 连接自动变成明文 HTTP/2。需要该模式时，使用 SetUnencryptedHTTP2，并明确评估部署连接范围。标准库采用预先知晓的 HTTP/2 模式，不支持旧式 Upgrade: h2c 升级。

服务端可以在同一明文端口支持 HTTP/1 和明文 HTTP/2。客户端有不同规则：同时启用 HTTP1 与 UnencryptedHTTP2 时，http:// URL 使用 HTTP/1；要让 Transport 对 http:// 使用明文 HTTP/2，应启用 UnencryptedHTTP2 且不启用 HTTP1。不要将明文协议设置直接套到公网 TLS 入口上。

在部署记录里区分允许集合与实际协议

示例提供 Request.Proto 与 Response.Proto 作为观察点，没有在本机运行或给出真实连接日志。读者可在自己的环境中分别用两类客户端访问，并记录响应是否符合预期；协议协商失败时，先核对双方允许集合和 TLS 设置。

如果有反向代理，客户端到代理与代理到 Go 服务是两段连接。Go 服务看到的请求协议只描述它接收的这一段，不能用来断言外部浏览器使用了什么协议。

需要修改默认 Transport 吗？

示例选择克隆后配置，使该客户端的协议约定不影响其他使用默认对象的代码。

只开启 HTTP/2 能兼容所有客户端吗？

不能。只支持 HTTP/1 的对端不属于允许范围，是否保留 HTTP/1 应根据实际调用方决定。

参考：Go Protocols 文档；Go 1.24 net/http 变更。