Go net/http Protocols.SetHTTP1 怎样让服务端只接受 HTTP/1

如果一个 Go 服务端只想接受 HTTP/1，关键不是把 Server.Protocols 留空，而是显式创建协议集合，再调用 SetHTTP1(true)。最小配置如下：nil 表示交给 net/http 采用默认协议集合；显式的 http.Protocols 只加入 HTTP/1，才是在配置上明确表达“仅 HTTP/1”。

服务端只接受 HTTP/1 时，使用 srv.Protocols = new(http.Protocols)，然后调用 srv.Protocols.SetHTTP1(true)。不要把 Server.Protocols == nil 当成“只启用 HTTP/1”。

为什么 nil 不是仅 HTTP/1

http.Server.Protocols 是服务端支持协议的集合指针。按照当前 net/http 的 API 说明，字段为 nil 时采用默认配置；在常见的 TLS 服务场景中，这个默认集合通常包含 HTTP/1 和 HTTP/2。也就是说，nil 是“使用默认策略”，不是一个精确的 HTTP/1-only 声明。

想控制协议范围，就先把意图落成一个独立的 http.Protocols 值。这个值的零状态不代表默认集合，而是一个空的协议集合；随后调用哪个 Set... 方法，就由代码明确加入哪种协议。

SetHTTP1(true) 的最小写法

下面的写法从一个空的显式集合开始，只打开 HTTP/1。将集合赋给 Server.Protocols 后，服务端的协议选择就不再依赖字段为 nil 时的默认值。

package main

import (
	"log"
	"net/http"
)

func main() {
	srv := &http.Server{
		Addr: ":8080",
	}

	// 从空集合开始，只加入 HTTP/1，明确服务端的协议边界。
	srv.Protocols = new(http.Protocols)
	srv.Protocols.SetHTTP1(true)

	// ListenAndServe 使用上面的协议集合启动服务端；错误通常意味着监听失败。
	log.Fatal(srv.ListenAndServe())
}

这里最重要的是两件事：第一，new(http.Protocols) 创建的是显式集合；第二，SetHTTP1(true) 把 HTTP/1 加入这个集合。代码没有调用 SetHTTP2(true)，所以这个配置没有主动加入 HTTP/2。

把协议集合挂到 Server 时看什么

可以把配置拆成“输入、集合、服务入口”三层来理解：Server.Protocols 是配置入口，http.Protocols 保存协议标志，http.Server 决定服务端接受哪些协议。只要集合中只有 HTTP/1，配置意图就保持单一。

如果一个集合可能由多个配置分支共同构造，建议在同一处明确最终状态，避免某个分支后来调用了其他 Set... 方法，导致“只接受 HTTP/1”的前提被悄悄改变。

几个容易混淆的边界

SetHTTP1 是添加还是切换

SetHTTP1(true) 的语义是把 HTTP/1 加入集合，SetHTTP1(false) 则移除它。它不是一个“把所有其他协议自动清空”的总开关。因此，只有在你从空集合开始，或者已经确认其他标志未打开时，才可以把它理解成 HTTP/1-only 配置。

显式集合为空会怎样

显式集合和 nil 是两种不同的表达：前者是调用方提供的协议集合，后者是让服务端走默认策略。生产代码中不要用“暂时留空，之后再看默认值”的方式代替协议决策；需要 HTTP/1 时，直接写出 SetHTTP1(true) 更容易审查和维护。

HTTP/1 与传输上下文

HTTP/1 可以运行在普通 TCP 服务或 TLS 服务上；本文只讨论服务端协议集合，不讨论证书文件、TLS 版本或明文 HTTP/2 的配置。若你的目标是启用其他协议，应单独审视对应的 SetHTTP2 或 SetUnencryptedHTTP2 配置，不要把它们混进“仅 HTTP/1”的结论。

排查配置不生效时的顺序

1. 先看 Server.Protocols 是否确实指向了显式的 http.Protocols。
2. 再看集合构造后是否调用过其他 Set... 方法，尤其是打开 HTTP/2 的分支。
3. 最后确认真正启动的就是这一个 Server 实例，而不是另一个使用默认配置的服务入口。

这三步是在核对配置数据的生命周期：协议意图先进入集合，集合再绑定到服务端，最后由启动入口使用。只检查某一行 SetHTTP1(true)，却不检查对象绑定关系，容易把另一处服务实例误认为当前配置。

总结

要让 Go net/http 服务端只接受 HTTP/1，请显式创建 http.Protocols，调用 SetHTTP1(true)，再把它赋给 Server.Protocols。nil 是默认协议策略，SetHTTP1 是集合成员操作，只有把这两个概念分开，协议边界才不会在维护过程中变得模糊。

相关问题

Server.Protocols 为 nil 时一定同时支持 HTTP/1 和 HTTP/2 吗？

它表示使用 net/http 的默认协议策略，具体结果还受服务端配置和传输环境影响；如果需要稳定表达 HTTP/1-only，应使用显式集合。

SetHTTP1(false) 能不能恢复默认协议？

不能。它只是从当前显式集合移除 HTTP/1，不会把 Server.Protocols 变回 nil，也不会自动恢复默认集合。

只设置 HTTP/1 是否需要配置 TLS？

不需要为了理解协议集合而额外配置 TLS。HTTP/1 的协议选择和证书部署是两个独立问题，按实际服务入口分别处理即可。