Go http.Transport.Protocols.SetHTTP2 怎样让客户端只使用 HTTP/2

我第一次把客户端改成“只走 HTTP/2”时，误以为把 ForceAttemptHTTP2 设为 true 就够了。它解决的是“要不要尝试 HTTP/2”，却没有表达“HTTP/1 是否仍然允许”。Go 1.24 起，标准库给出了更直接的协议集合入口：http.Transport.Protocols。

官方地址：https://pkg.go.dev/net/http#Transport

真正的 HTTP/2-only 配置应该是：克隆可复用的 Transport，创建 http.Protocols，打开 SetHTTP2(true)，并明确关闭 SetHTTP1(false)。请求使用 HTTPS；如果服务端不提供 HTTP/2，客户端就不会偷偷退回 HTTP/1。

先把 ForceAttemptHTTP2 和 Protocols 分开看

ForceAttemptHTTP2 是 Transport 的兼容开关，主要影响自定义拨号器或 TLS 配置存在时是否尝试 HTTP/2。它不是协议白名单。Protocols 才是客户端支持集合，零值为空集合，里面可以分别包含 HTTP/1、TLS 上的 HTTP/2，以及明文 HTTP/2。

用 Protocols 明确只允许 HTTP/2

下面的写法把协议选择集中在一个副本中。克隆默认 Transport 可以保留代理、连接复用和基础拨号行为；新建协议集合后只打开 HTTP/2，避免修改全局默认对象。

package main

import (
    "fmt"
    "net/http"
)

func newHTTP2OnlyClient() *http.Client {
    // 克隆默认 Transport，保留连接复用等基础能力，避免修改全局对象。
    transport := http.DefaultTransport.(*http.Transport).Clone()

    // 协议集合只放入 TLS 上的 HTTP/2，显式移除 HTTP/1 回退。
    transport.Protocols = new(http.Protocols)
    transport.Protocols.SetHTTP1(false)
    transport.Protocols.SetHTTP2(true)

    return &http.Client{Transport: transport}
}

func main() {
    client := newHTTP2OnlyClient()

    // 只对 HTTPS 发请求；明文 http:// 不属于这里的 HTTP/2-only 目标。
    response, err := client.Get("https://example.com/")
    if err != nil {
        fmt.Println("HTTP/2 请求失败：", err)
        return
    }
    // 及时关闭响应体，避免连接复用被未读响应占住。
    defer response.Body.Close()
    fmt.Println("协商协议：", response.Proto)
}

这里的关键不是 SetHTTP2(true) 单独出现，而是协议集合里没有 HTTP/1。response.Proto 可以记录返回的协议字符串；它适合写入诊断日志，但不要把日志输出当成配置本身。

TLS、服务端能力和明文 h2c 是三件事

标准库文档把 HTTP/2 定义为 TLS 上的协议，而未加密 HTTP/2 是另一个显式选项 UnencryptedHTTP2。因此，HTTP/2-only 客户端通常使用 https://，并让服务端证书和 ALPN 协商正常完成。

有三个容易混淆的边界：

• 服务端只支持 HTTP/1：HTTP/2-only 客户端没有可用回退，应该把它当作部署或兼容性错误处理。
• 地址是 http://：这不是 TLS 上的 HTTP/2；不要为了“看起来能通”随意打开明文 h2c。
• 自定义拨号或 TLS：ForceAttemptHTTP2 可能影响自动尝试，但仍应以 Protocols 表达最终允许集合。

请求失败时怎样留下有用线索

协议限制属于连接前提，不适合在业务层捕获错误后再自动改用 HTTP/1。更稳妥的做法是把目标 URL、Transport 配置摘要和错误一起记录，并区分服务端能力不足、TLS/ALPN 问题与普通网络失败。

func getHTTP2Only(client *http.Client, target string) error {
    // 先限制入口，避免调用方把明文地址混入 HTTP/2-only 请求。
    if len(target) 

示例中的字符串判断只是文章演示，生产代码也可以使用 net/url 解析后检查 Scheme。重点是失败时保留原始错误，并且不要用一次失败触发隐式降级。

最后记住这张配置表

如果你的目标是“必须使用 HTTP/2”，就把协议集合当成白名单来写；如果你的目标是“尽量使用 HTTP/2”，才考虑保留 HTTP/1。两者的差别不在一句开关，而在是否允许回退。

相关问题

只设置 ForceAttemptHTTP2 会自动禁用 HTTP/1 吗？

不会。它主要控制是否尝试 HTTP/2，不能代替 Transport.Protocols 对允许协议的声明。

为什么 HTTP/2-only 客户端应优先使用 HTTPS？

标准库把 TLS 上的 HTTP/2 与明文 HTTP/2 分成两个协议选项；普通 HTTPS 请求对应前者，明文 h2c 需要单独的配置和部署约定。