Go http.Transport.HTTP2 怎样设置 HTTP/2 连接参数

http.Transport.HTTP2 负责 HTTP/2 的高级连接参数，Transport.Protocols 才负责声明允许哪些协议。想让客户端稳定使用 HTTP/2，通常要先复制并复用一个 Transport，再显式设置 Protocols.SetHTTP2(true)，最后按客户端语义填写 HTTP2Config。不要把服务端专属字段当成客户端并发开关。

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

Transport.Protocols 和 Transport.HTTP2 分别负责什么

这两个字段处在不同层次。Transport.Protocols 是协议集合：它决定 Transport 是否包含 HTTP/1、HTTP/2 或未加密 HTTP/2。Transport.HTTP2 则指向 HTTP2Config，用于设置 HTTP/2 连接的高级行为。前者回答“能不能选这个协议”，后者回答“选中 HTTP/2 后如何管理连接”。

对 HTTPS 请求来说，HTTP/2 还要经过 TLS 协商；配置了 HTTP/2 并不等于服务端一定会选择它。Transport 也应当长期复用，频繁创建新实例会丢失连接池收益。

先复制 Transport，再显式打开 HTTP/2

如果应用从默认 Transport 开始定制，先调用 Clone，保留默认拨号、代理和连接池行为，再替换协议配置。下面的示例只展示配置边界，不代表已经向某个真实服务发起请求：

package main

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

func newHTTP2Client() *http.Client {
    // Clone 保留默认 Transport 的代理、拨号和连接池设置。
    tr := http.DefaultTransport.(*http.Transport).Clone()
    tr.Protocols = new(http.Protocols)
    // 同时保留 HTTP/1，只有需要纯 HTTP/2 时才移除它。
    tr.Protocols.SetHTTP1(true)
    tr.Protocols.SetHTTP2(true)
    tr.HTTP2 = &http.HTTP2Config{
        // 空闲窗口内没有流量时，按需发送 PING 保持连接状态。
        SendPingTimeout: 30 * time.Second,
        // PING 发出后，超过这个时间没有响应就关闭连接。
        PingTimeout: 15 * time.Second,
        // 写入持续没有进展时，避免连接无限占用资源。
        WriteByteTimeout: 20 * time.Second,
        // 把 HTTP/2 错误类型交给应用指标系统记录。
        CountError: func(errType string) {
            log.Printf("http2 error: %s", errType)
        },
    }
    return &http.Client{Transport: tr}
}

这里的关键不是把所有字段都填上，而是把职责分开：Protocols 负责能力集合，HTTP2Config 负责连接策略。若自定义了 TLS 配置或拨号器，还要结合 Transport 的 HTTP/2 默认启用规则检查是否需要显式配置协议。

HTTP2Config 哪些字段适用于客户端

客户端配置最容易误解的是字段名看起来都像“并发或性能参数”，实际适用范围并不相同。SendPingTimeout 关注空闲连接的健康探测窗口，PingTimeout 关注 PING 发出后的响应等待，WriteByteTimeout 关注写入没有任何进展时的连接回收，CountError 则把错误分类交给监控系统。

MaxReadFrameSize 属于帧读取边界，使用时要根据对端、内存预算和兼容性说明清楚；不要为了追求吞吐盲目放大。另一个常见误区是 MaxConcurrentStreams：官方文档明确它只适用于服务器，客户端不应把它当成“限制自己同时发多少请求”的通用开关。

零值、超时和错误观测怎么一起判断

零值语义要以当前 Go 版本文档为准：有的字段零值意味着使用默认值，有的字段零值表示不启用该能力。配置变更后应把版本、字段注释和服务端协商条件一起记录，避免只看代码中的数字。

常见问题

设置了 HTTP2Config，为什么请求仍然不是 HTTP/2？

因为 HTTP2Config 不负责协议选择。先确认 Transport.Protocols 包含 HTTP/2，再检查 TLS、服务端协商和自定义拨号器是否改变了默认启用条件。

MaxConcurrentStreams 能限制客户端并发请求吗？

不能按这个目的理解。它是服务端配置语义；客户端并发应在应用层通过队列、信号量或请求调度控制。

CountError 回调里应该做什么？

适合做非阻塞的计数、采样或分类记录。不要在回调里执行慢 IO，否则错误观测本身可能放大连接问题。