paho.mqtt.golang是客户端SDK，不适用于千万级网关，因其阻塞握手、无法复用连接、不暴露net.Conn、需重复实现ACL/路由/retain等核心功能，且易导致内存暴涨和goroutine泛滥。
为什么不用 paho.mqtt.golang 做千万级网关
因为它是客户端 SDK，不是网络接入层。用它写网关等于让每个设备连接都走一个独立的 MQTT 客户端实例——内存暴涨、goroutine 泛滥、QoS 2 状态无法统一管理，根本撑不住百万连接。真正要重构网关，得从 TCP 连接收口开始，而不是从“发几条 PUBLISH”开始。
常见误判是：以为换更快的序列化（如 CBOR）或调高 QoS 就能扩容。实际瓶颈在连接数和协议解析开销。gnet 绕过 net/http 和标准 net.Conn 抽象，直接操作 epoll/kqueue，单机轻松维持 100 万+ 并发连接，这才是千万级的底座。
-
paho.mqtt.golang的Connect()是阻塞握手 + session 管理，不适合做服务端入口 - 它不暴露底层
net.Conn，没法做连接复用、TLS 分流、报文预检等网关级控制 - 所有消息路由、ACL、retain 消息投递逻辑都得自己重写一遍，等于重复造轮子
gnet 如何解析 MQTT CONNECT 报文而不 panic
MQTT 协议头固定 2 字节，但剩余长度字段是可变字节数（最多 4 字节），直接 conn.Read(buf[:2]) 读完就 decode 会越界或截断。gnet 的 React 回调里必须手动做缓冲与定长提取。
实操要点：
- 用
gnet.OnOpened分配固定大小 buffer（比如 1024 字节），绑定到c.Context()避免频繁 alloc - 在
React中先检查已读字节数是否 ≥ 2；不够就return nil等下次触发 - 解析前 2 字节后，按 MQTT 规范计算剩余长度字段字节数（
(b & 0x7F) 循环），再判断 buffer 是否足够；不足就暂存并返回 <code>nil - 严禁在
React中调用任何阻塞 IO（如fmt.Println或 DB 查询），否则整个 event-loop 卡死
示例关键片段：
func (ev *server) React(c gnet.Conn, inBuf []byte) (outBuf []byte, action gnet.Action) {
ctx := c.Context().(*connCtx)
n := copy(ctx.buf[ctx.offset:], inBuf)
ctx.offset += n
if ctx.offset < 2 { return nil, gnet.None }
// 解析 fixed header...
}
如何在 gnet 中实现设备 ID 提取与连接鉴权
MQTT CONNECT 报文里 clientID、username、password 都在 payload 区，且未加密。不能等完整报文收齐再鉴权——得边收边验，避免恶意连接耗尽 buffer。
推荐做法是：收到前 2 字节确认是 CONNECT（type == 0x10）后，立即解析可读部分，提取 clientID 字段做白名单/速率限制，失败则 c.Close()。
- 别等整个 CONNECT 报文收完再鉴权；攻击者可发超长 clientID 卡住你
- clientID 必须全局唯一，建议用
device_type:sn格式，方便后续路由和 ACL 匹配 - 鉴权失败时，用
c.Write([]byte{0x20, 0x02, 0x00, 0x00})发送 CONNACK(0x0000) 拒绝，符合协议规范 - 用户名密码校验建议异步走 channel + worker pool，避免阻塞 React
QoS 1 消息去重状态该存在哪
千万级网关不能把每个连接的 inflight 状态全放内存——OOM 是分分钟的事。gnet 无 session 概念，需自行设计轻量存储策略。
生产环境真实方案：
- 用 LRU cache（如
github.com/hashicorp/golang-lru）存最近 10 万条packetID → timestamp映射，淘汰策略按时间 + 访问频次 - 对高频设备（如网关下挂的子设备），把 packetID 哈希后分片写入 Redis Cluster，key 设为
qos1:dev:{shard}:，TTL 设为 5 分钟 - 绝对不要用 map[string]bool 全局存——map 扩容时会 STW，连接突增时 GC 压力爆炸
- QoS 1 的 PUBACK 收到后，必须原子删除状态；用
sync.Map或 CAS 操作，避免漏删导致重复投递
最易被忽略的一点：MQTT V3.1.1 不要求 broker 对重复 packetID 做幂等处理，但设备端往往假设 broker 会去重。如果你的网关没做这层，下游设备就会收到双份指令。
