Go http.Protocols 怎样让 Server 接收未加密 HTTP/2

如果 Go 服务端需要在同一个端口接收 HTTP/1 和未加密 HTTP/2，Go 1.24 起可以用 http.Protocols 明确写出协议集合，而不是依赖默认值猜测。关键配置是同时打开 HTTP1 与 UnencryptedHTTP2；后者就是通常所说的 h2c 接入边界。

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

先把协议集合显式配置到 http.Server.Protocols，再确认客户端是否以未加密 HTTP/2 方式连接。它不等于 HTTPS，也不会替你配置证书或把普通 HTTP/1 请求自动升级成任意 HTTP/2 流程。

先确认 Protocols 的协议集合

http.Protocols 是一个协议集合，支持分别判断和设置 HTTP1、TLS 上的 HTTP2 与未加密连接上的 UnencryptedHTTP2。Server.Protocols 为 nil 时使用默认协议策略；如果要排障或灰度，最好改成显式集合，让配置意图可以从代码中直接读出来。

需要注意名称：HTTP2 表示 TLS 连接上的 HTTP/2，UnencryptedHTTP2 表示明文 TCP 上的 HTTP/2。两者是不同的成员，不能因为启用了一个就推断另一个也可用。

给 Server 配置未加密 HTTP/2

下面的配置让服务端保留 HTTP/1，同时允许未加密 HTTP/2。代码只展示配置关系，是否能接入还取决于客户端是否按对应的 HTTP/2 明文协议发起连接。

package main

import (
    "log"
    "net/http"
)

func main() {
    protocols := new(http.Protocols)
    protocols.SetHTTP1(true)              // 保留普通 HTTP/1 接入
    protocols.SetUnencryptedHTTP2(true)  // 允许明文 TCP 上的 HTTP/2

    server := &http.Server{
        Addr:     ":8080",
        Handler:  http.HandlerFunc(handle),
        Protocols: protocols, // 显式声明服务端协议集合
    }

    // 示例只负责启动服务；生产环境还应接入自己的退出与日志策略。
    log.Fatal(server.ListenAndServe())
}

func handle(w http.ResponseWriter, r *http.Request) {
    // 用协议版本回显当前请求，便于接入方在日志中区分协议。
    _, _ = w.Write([]byte(r.Proto))
}

这里的两个开关是独立的：只调用 SetUnencryptedHTTP2(true)，并不会自动把 HTTP/1 纳入集合；只调用 SetHTTP1(true)，也不会开放明文 HTTP/2。服务端需要哪些协议，就在同一个 Protocols 值上逐项声明。

区分 h2c 与 TLS HTTP/2

h2c 的核心特征是“HTTP/2 over cleartext”，也就是没有 TLS 的 HTTP/2。它适合内网、受控代理链或已经有独立网络保护的场景；如果客户端在公网或不可信网络中访问，不能把 h2c 当作 HTTPS 的替代品。

尤其不要只在浏览器地址栏输入普通 http:// 地址，就认为客户端会自动使用未加密 HTTP/2。浏览器、代理和网关是否支持这种连接方式，要按实际链路单独确认；本文配置只定义 Go 服务端允许的协议集合。

上线前保留回滚配置

协议开关上线时，建议把“当前显式配置”和“回滚到默认策略”当成两个清楚的配置版本。若某个代理只会发 HTTP/1，保留 SetHTTP1(true) 可以避免把兼容性问题误判成服务不可用；若 h2c 链路没有经过受控网络，则应移除 SetUnencryptedHTTP2(true)，回到只开放必要协议的方案。

可以按下面的顺序做配置复查：

1. 确认服务端运行版本包含 http.Protocols，并明确记录目标协议。
2. 确认 HTTP1、TLS HTTP2、UnencryptedHTTP2 三者没有被混为一个“HTTP/2 开关”。
3. 确认网关到服务端之间确实允许对应的明文 HTTP/2 连接方式。
4. 保留一份移除 h2c 开关的回滚配置，出现协议协商异常时先恢复最小协议集合。

常见问题

只设置了 UnencryptedHTTP2，为什么旧客户端仍然连不上？

因为旧客户端可能只会发送 HTTP/1。若需要兼容它，应同时开启 HTTP1，并确认服务端入口没有被其他代理配置覆盖。

开启 HTTP2 是否就等于开启 h2c？

不是。HTTP2 对应 TLS 上的 HTTP/2，UnencryptedHTTP2 才对应明文 HTTP/2；根据链路安全边界分别选择。

为什么不直接依赖 Protocols 的零值？

零值适合默认场景，但排查协议兼容性时不够直观。显式集合能把服务端到底接受什么写进代码和配置记录，回滚时也更容易对照。

总结：把 Server.Protocols 当作协议白名单来维护，HTTP/1、TLS HTTP/2 和 h2c 分别判断；需要未加密 HTTP/2 时显式调用 SetUnencryptedHTTP2(true)，并为网络边界和回滚路径留下记录。