不能直接用 http.Server 做多协议网关入口，因其 Accept 后强制解析 HTTP 头部，对 gRPC、MQTT、WebSocket 等非 HTTP 流量会 panic 或静默关闭连接；必须用自定义 net.Listener 在 Accept 后仅读前 16 字节做协议探测，再分发至对应协议服务，全程零消费 Body、严守帧边界。
Go 语言本身不提供“多协议动态网关”这种开箱即用的组件，所谓“通过语言学习实现”，本质是理解 net.Conn 底层控制权、协议帧边界、上下文透传这三件事——不是学语法，而是学怎么放弃 http.Server 的自动解析，亲手接管连接。
为什么不能直接用 http.Server 做统一入口
http.Server 在 Accept 后会立即尝试解析 HTTP 请求行和头部。一旦遇到非 HTTP 流量（比如 gRPC 的 PRI * HTTP/2.0 前缀、MQTT 的 0x10 CONNECT 控制字节），它要么 panic，要么静默关闭连接。常见现象包括：
- gRPC 客户端报错：
rpc error: code = Internal desc = transport: received the unexpected content-type "text/plain" - WebSocket 连接卡在 101 Upgrade，但后端收不到任何帧
- MQTT 设备连不上，tcpdump 显示 SYN-ACK 后立刻 RST
根本原因：它读取并缓冲了连接前若干字节用于 HTTP 解析，后续协议解析器再也拿不到原始帧头。
必须用自定义 net.Listener 做协议探测
核心动作是在 Accept() 返回 net.Conn 后，只读前 16 字节做 peek，然后根据特征字节分发到对应协议处理器，全程不消费 body、不破坏帧边界。
立即学习“go语言免费学习笔记（深入）”；
-
buf[0] == 0x16→ TLS record（需进一步 ALPN 或 SNI 判断是 HTTPS/MQTT-TLS/gRPC-TLS） -
bytes.HasPrefix(buf, []byte("GET ")) || bytes.HasPrefix(buf, []byte("POST "))→ HTTP/1.1 -
buf[0]&0xf0 == 0x10→ MQTT CONNECT（0x10是 MQTT 固定头第一位） -
bytes.HasPrefix(buf, []byte("PRI * HTTP/2.0"))→ HTTP/2（gRPC 流量）
读完立刻调用 conn.SetReadDeadline() 防止 TLS 握手阻塞整个 accept 循环；分发后，把 conn 包装成 &peekConn{Conn: conn, buf: buf[:n]} 交给下游，确保首段数据可被二次读取。
http.Handler 只能处理 HTTP 和 WebSocket 升级
HTTP 流量和 WebSocket 升级请求可以共用一个 http.Server 实例，但必须满足两个硬性条件：
- WebSocket 路由必须放在中间件链最外层，不能有任何中间件提前调用
r.Body.Read()或io.ReadAll(r.Body)，否则upgrader.Upgrade()会返回http.ErrBodyReadAfterClose - gRPC-Web 必须走子路径（如
/grpc/），用grpcweb.WrapServer()包装已有*grpc.Server，不能注册到http.DefaultServeMux - 同一路径根据
Accept头分流时，要显式检查r.Header.Get("Accept")，比如application/grpc+json走 gRPC-JSON 编解码，text/event-stream触发 SSE 推送
注意：http.ServeMux 不支持运行时热更新路由规则，若需动态路由，得用 httprouter 或自研前缀树 + sync.Map 缓存，避免正则遍历拖垮 QPS。
非 HTTP 协议必须独立启动 goroutine 处理 net.Conn
MQTT、CoAP、自定义二进制协议完全不在 HTTP 协议栈内，http.Server 根本没机会解析它们。实操要点：
- 每个协议启动独立 goroutine：
go handleMQTT(conn)、go handleCoAP(conn)，避免阻塞主 accept 循环 - 务必设置
conn.SetReadDeadline()和conn.SetWriteDeadline()，否则空闲连接会永久卡住 goroutine - 别用
gob或未预编译的protobuf做设备通信序列化；CBOR 更适合 IoT 场景（体积小、Go 原生支持、无 schema 强约束） - MQTT Broker 别用客户端库模拟服务端，生产环境直接集成
github.com/fhmq/hmq或github.com/mochi-mqtt/server
协议转换永远不能靠 magic bytes 自动推测——TLS 流中前几个字节可能被加密，或不同协议帧头重叠。所有编解码器必须显式声明并绑定到路由规则，比如 RouteRule{Protocol: "mqtt", Codec: &cborCodec{}}。
