应使用gorilla/websocket而非net/http，因后者仅支持HTTP握手，缺乏帧解析、Ping/Pong心跳、连接状态管理等能力，硬实现易出错；前者封装RFC 6455全流程，自动响应控制帧、支持读写超时与安全广播。
为什么用 gorilla/websocket 而不是 net/http 自带的升级逻辑
因为 net/http 不提供 WebSocket 协议的帧解析、心跳维持、连接状态管理等能力，硬写容易漏掉 CloseMessage 处理或 Ping/Pong 响应，导致连接被代理（如 Nginx）静默断开。而 gorilla/websocket 封装了 RFC 6455 的关键行为，比如自动响应 Ping、支持 SetReadDeadline 防呆滞连接、内置 WriteJSON 序列化，实操中能少踩 80% 的连接超时和粘包问题。
常见错误现象：websocket: close sent 后客户端收不到后续消息；或 Nginx 日志出现 upstream prematurely closed connection —— 这基本是没调用 conn.SetPingHandler 或没设读写 deadline。
- 必须在
Upgrade后立即设置conn.SetReadLimit(512 * 1024)防大 payload 攻击 - 服务端每 30 秒发一次
Ping：用conn.SetPongHandler(conn.PongHandler())+ 定时器conn.WriteMessage(websocket.PingMessage, nil) - 不要复用
http.ResponseWriter，Upgrader.Upgrade()返回的*websocket.Conn才是唯一通信句柄
如何安全地广播实时数据而不阻塞主线程
直接在 HTTP handler 里循环调用 conn.WriteJSON() 会阻塞，尤其当某客户端网络卡顿，整个广播就 hang 住。正确做法是把连接抽象为带缓冲 channel 的结构体，用独立 goroutine 消费消息。
使用场景：大屏通常只需下发，不需回传指令，所以可省略 client 回写逻辑，专注“单向高吞吐推送”。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 每个
*websocket.Conn绑定一个chan []byte（缓冲大小设为 64，防内存暴涨） - 用 map 存所有活跃连接：
map[*websocket.Conn]chan []byte，读写加sync.RWMutex保护 - 广播时遍历 map，向每个 channel 发送序列化后的
[]byte；若 channel 满（select default），则delete该连接并conn.Close() - 每个连接配专属 goroutine：
for msg := range ch { conn.WriteMessage(websocket.TextMessage, msg) }，异常时退出并清理 map
json.Marshal 性能不够？试试 easyjson 或预分配 bytes.Buffer
大屏每秒可能推送 50+ 条结构化数据（如车辆位置、设备状态），频繁 json.Marshal 会触发大量小对象 GC，pprof 显示 runtime.mallocgc 占比超 35%。这不是代码逻辑问题，是序列化层瓶颈。
参数差异：easyjson 生成的 MarshalJSON() 方法避免反射，比原生快 3–5 倍；而预分配 bytes.Buffer 可减少底层数组扩容次数。
- 对高频结构体（如
type Stat { CPU float64 `json:"cpu"` }）运行easyjson -all stat.go - 若不想引入新工具，改用
var buf bytes.Buffer; buf.Grow(512); json.NewEncoder(&buf).Encode(data) - 禁止在广播循环里做
fmt.Sprintf或字符串拼接，JSON 字段名重复出现时，提前存为const cpuKey = "cpu"
Nginx 反向代理下 WebSocket 连接频繁断开怎么办
本质是 Nginx 默认配置不兼容长连接：proxy_read_timeout 默认 60 秒，且未透传 Upgrade 和 Connection 头。客户端看似连上了，实际 60 秒后被 Nginx 主动 kill。
性能影响：未配妥时，大屏每分钟重连 1–2 次，前端看到数据跳变、loading 闪现；配妥后连接稳定数小时无中断。
- Nginx 配置必须包含：
proxy_set_header Upgrade $http_upgrade;、proxy_set_header Connection "upgrade";、proxy_read_timeout 86400; - Golang 服务端
Upgrader.CheckOrigin = func(r *http.Request) bool { return true }（生产环境应校验 Referer 或 token） - 若用云厂商 SLB（如阿里云 CLB），需确认其“WebSocket 超时时间”已调至最大值（通常 4000 秒起），否则 Nginx 配再久也白搭
真正复杂的是多实例部署时的广播一致性——gorilla/websocket 本身不解决跨进程同步，得靠 Redis Pub/Sub 或消息队列中转，这点容易被忽略。
