登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go net/http.Protocols.HTTP2 怎样判断 Protocols 是否允许 HTTP/2

来源:17golang原创

时间:2026-11-20 04:53:01 135浏览 收藏

如果你只想知道 http.Protocols 是否允许 HTTP/2,直接调用 p.HTTP2()。返回 true 表示协议集合包含 HTTP/2,返回 false 表示没有包含;它不会探测远端、读取连接状态,也不代表某一次请求已经协商成 HTTP/2。

官方地址:https://pkg.go.dev/net/http#Protocols.HTTP2

这个判断适合放在配置检查、日志说明或启动前的策略决策中。真正的连接协商还要看 TLS、Transport、Server 以及对端能力。

先把 HTTP2 当成协议集合成员

Protocols 是一组 HTTP 协议的集合,零值是空集合。官方定义中,HTTP1 表示 HTTP/1.0 和 HTTP/1.1,HTTP2 表示 TLS 连接上的 HTTP/2,UnencryptedHTTP2 则是未加密 TCP 上的 HTTP/2。

因此,HTTP2() 的语义非常窄:它只检查这一位是否存在。下面的辅助函数把 nil、零值和已开启三种情况表达清楚。

package main

import (
    "fmt"
    "net/http"
)

// allowsHTTP2 只判断协议集合,不探测网络连接或远端能力。
func allowsHTTP2(p *http.Protocols) bool {
    if p == nil {
        // 没有配置对象时,按空集合处理。
        return false
    }
    return p.HTTP2()
}

func main() {
    var p http.Protocols
    fmt.Println(allowsHTTP2(&p)) // 零值不包含 HTTP/2

    p.SetHTTP2(true)             // 将 HTTP/2 加入集合
    fmt.Println(p.HTTP2())       // 现在成员判断为 true

    p.SetHTTP2(false)            // 移除 HTTP/2,避免残留配置
    fmt.Println(p.HTTP2())
}

这里的关键是接收者:HTTP2() 使用值接收者读取集合,SetHTTP2 使用指针接收者修改集合。若配置对象来自 Server.Protocols 或 Transport.Protocols,通常直接对指针字段调用设置方法即可。

读取结果时不要把成员判断当成连接探测

Protocols 协议集合中 HTTP1、HTTP2 和未加密 HTTP2 成员的静态关系说明图
图1:静态结构说明图,展示 HTTP2() 读取的是协议集合成员,不是一次请求的协商结果。

例如,下面的判断可以用于启动日志或配置分支,但不能据此写出“当前客户端已经使用 HTTP/2”的结论:

func describeProtocols(p *http.Protocols) string {
    if p == nil {
        // nil 没有协议集合,避免直接调用方法造成误解。
        return "未配置协议集合"
    }
    if p.HTTP2() {
        // 这里只能说明 HTTP/2 在允许集合中。
        return "允许 HTTP/2"
    }
    return "未允许 HTTP/2"
}

这个结果回答的是“配置允许什么”,不是“连接最终用了什么”。如果需要记录真实请求的协议版本,应在请求处理上下文中观察请求或响应对象的协议字段,并把那件事与配置判断分开记录。

在 Server 和 Transport 中分别看协议边界

服务端和客户端都可以通过 Protocols 控制允许的协议集合,但 HTTP/2 的传输边界不同。启用 HTTP2 表示 TLS 上的 HTTP/2;若是明文 TCP 场景,应该明确使用 SetUnencryptedHTTP2(true),不能只检查 HTTP2()。

func enableServerProtocols(srv *http.Server) {
    // 新建集合,避免把默认策略和本次策略混在一起。
    srv.Protocols = new(http.Protocols)
    srv.Protocols.SetHTTP1(true) // 保留常见的 HTTP/1 入口
    srv.Protocols.SetHTTP2(true)  // 允许 TLS 上的 HTTP/2
}

func enableClientProtocols(tr *http.Transport) {
    // Transport 复用时先准备独立集合,再显式写入策略。
    tr.Protocols = new(http.Protocols)
    tr.Protocols.SetHTTP1(true)
    tr.Protocols.SetHTTP2(true)
}

配置完成后可以用 srv.Protocols.HTTP2() 或 tr.Protocols.HTTP2() 做成员判断。若你想允许明文 HTTP/2,则还需要单独判断 UnencryptedHTTP2();两者是不同的集合成员。

用四个问题判断代码是否写对

Server、Transport、TLS 与实际连接协商之间职责边界的静态结构说明图
图2:静态结构说明图,区分配置集合、TLS 传输边界与实际连接状态的职责。
  • 调用对象是否可能为 nil?如果可能,先做空指针分支。
  • 你要问的是“集合允许 HTTP/2”,还是“本次请求已经使用 HTTP/2”?前者用 HTTP2(),后者不能只看它。
  • 连接是否加密?TLS 上的 HTTP/2 看 HTTP2(),明文 HTTP/2 还要单独看 UnencryptedHTTP2()。
  • 修改的是哪一个对象?SetHTTP2 会改变当前 Protocols,不要把一个临时副本当成 Server 或 Transport 的真实配置。

可以把最终判断写成一句话:Protocols.HTTP2() 是配置集合的布尔成员查询,适合判断策略,不适合代替网络探测、TLS 检查或请求版本记录。

常见问题

HTTP2() 返回 false,是不是 Go 不支持 HTTP/2?

不一定。它通常只说明当前 Protocols 集合没有包含 HTTP/2,或者你读取的是零值对象。先检查配置对象是否正确设置,再区分 Server、Transport 和 TLS 场景。

设置了 HTTP/2,为什么请求仍然可能不是 HTTP/2?

因为设置只是允许集合的一部分。协商还受连接是否使用 TLS、对端能力、Transport 或 Server 的完整配置影响;不要把 SetHTTP2(true) 当成单次连接结果。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>