Golang HTTP/3 QUIC协议尝试_下一代Web传输协议实践

go 1.20+ 标准库原生不支持 http/3，必须使用 quic-go + http3 第三方库；服务端需用 http3.server 和 quic.listener，客户端需用 http3.roundtripper 或支持 http/3 的 curl。

Go 1.20+ 原生不支持 HTTP/3，别白费劲写 http.ListenAndServeTLS

Go 官方标准库至今（包括 1.23）**没有内置 HTTP/3 实现**。你用 http.ListenAndServeTLS 或 http.Server 配任何 TLS 设置，都只会跑在 HTTP/1.1 或 HTTP/2 上——压根不会协商 QUIC。这不是配置问题，是语言层缺失。

常见错误现象：
• 启动服务后用 curl -v --http3 https://localhost:8080 报错 HTTP/3 is not supported in this build
• 浏览器 DevTools 的 Network 面板里看不到 h3 协议标识
• chrome://net-internals/#quic 查不到连接记录

• 目前唯一靠谱路径是用第三方库：quic-go + http3（同团队维护）
• 它不是对标准 net/http 的简单扩展，而是完整重写的 Server/Client 接口，不能混用 http.Handler 直接传入
• 必须显式启动 QUIC listener，且 TLS 证书需支持 ALPN 协议列表包含 h3

quic-go 启动 HTTP/3 Server 的最小可行写法

别抄网上过时的 demo（比如用已废弃的 quic-go/http3 v0.30 以下版本），当前稳定用法基于 v0.40+。核心是替换掉 http.Server，改用 http3.Server 并绑定 quic.Listener。

实操要点：

立即学习“go语言免费学习笔记（深入）”；

• 证书必须用 crypto/tls 加载，并确保 Config.NextProtos 包含 "h3"（否则客户端连不上）
• http3.Server 的 Handler 字段接受标准 http.Handler，这点比想象中友好
• 监听地址用 quic.ListenAddr，端口建议避开 443（开发时容易被占），比如 ":4433"
• QUIC 默认用 udp，防火墙/路由器要放行对应端口，且不走 TCP 代理链

简短示例：

ln, err := quic.ListenAddr(":4433", tlsConfig, &quic.Config{}) if err != nil {     log.Fatal(err) } server := &http3.Server{     Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {         w.Write([]byte("hello h3"))     }), } server.Serve(ln)

客户端请求 HTTP/3 必须用 http3.RoundTripper，curl 要编译带 nghttp3 支持

Go 标准 http.Client 会无视服务器是否支持 HTTP/3，永远走 TCP+TLS —— 因为它根本没实现 QUIC 底层。想发真正 HTTP/3 请求，客户端也得换轮子。

常见错误现象：
• 用 http.Get("https://...") 看起来成功，但抓包发现全是 TCP 流量
• curl 报 Unsupported protocol 或静默回落到 HTTP/2

• Go 客户端：必须用 http3.RoundTripper 替换默认 Transport，且需传入 quic.Config
• curl：系统自带版本基本不支持 HTTP/3；需从源码编译，依赖 nghttp3 + openssl 3.0+，命令加 --http3 才生效
• 浏览器：Chrome/edge 110+ 默认开启，但只对 HTTPS 域名、且需通过真实域名（非 localhost）或手动启用 chrome://flags/#enable-quic

ALPN 和证书是 HTTP/3 成功协商的前提，不是可选项

HTTP/3 不是“换个端口就行”的协议。它依赖 TLS 1.3 的 ALPN（应用层协议协商）机制，在握手阶段就约定用 h3，否则客户端根本不知道该切 QUIC。这步失败，后续全白搭。

关键检查点：

• 生成证书时，用 openssl 或 mkcert 确保 NextProtos 列表含 "h3"（Go 代码里也要显式设置）
• 用 openssl s_client -alpn h3 -connect localhost:4433 验证 ALPN 是否返回 Protocol : h3
• QUIC 要求 0-RTT 兼容，所以证书私钥不能用太老的算法（如 RSA-1024），推荐 ECDSA P-256 或 RSA-2048+
• HTTP/2 和 HTTP/3 可共存于同一端口（靠 ALPN 分流），但 Go 的 quic-go 当前不支持单 listener 同时跑 h2+h3，得分开端口

ALPN 没配对，QUIC 连接会在 TLS 握手后直接断开，日志里可能只看到 quic: cannot start server: no application protocol 这类模糊提示。