Gorilla WebSocket是最稳妥的长连接选择，因其封装了连接生命周期管理、心跳保活和并发安全的读写分离，而标准库net/http缺乏这些能力；需绕过中间件干扰、用Context绑定业务元数据、服务端主动心跳并每次读写前重设deadline。
为什么 Gorilla WebSocket 是微服务里最稳妥的长连接选择
因为标准库 net/http 的 Upgrader 实现不支持连接生命周期管理、心跳保活和并发安全的读写分离，而 Gorilla WebSocket 在这些地方做了扎实封装。它不是“更酷”，而是把 conn.WriteMessage() 和 conn.ReadMessage() 背后那些容易出错的状态同步、缓冲区复用、goroutine 泄漏控制都藏好了。
初始化连接时必须绕开的三个 HTTP 中间件陷阱
微服务通常挂了 gin 或 echo，但 WebSocket 升级请求不能被中间件干扰——尤其是日志、鉴权、CORS 中间件，它们可能提前写响应头或关闭 body。正确做法是：在路由注册阶段就用原生 http.ServeMux 或框架的 “raw handler” 接入。
- 用
gin.Engine.NoRoute()拦截未匹配路径，再判断r.Header.Get("Upgrade") == "websocket" - 禁用所有中间件：直接调用
upgrader.Upgrade(w, r, nil)，别传http.Header做 CORS，改用CheckOrigin回调控制来源 - 升级后立即 detach：
http.Hijack()已由Upgrader封装，不要手动调，否则会 panic
如何让每个连接真正“属于”某个微服务实例
WebSocket 连接本身无状态，但你的业务需要绑定用户 ID、设备 ID 或会话上下文。靠 conn.SetContext() 存元数据最轻量，但要注意：它只在当前 goroutine 有效；跨 goroutine（比如心跳协程）读取需用 context.WithValue() + 自定义 key，且 key 必须是导出变量。
- 升级成功后立刻执行：
ctx := context.WithValue(r.Context(), userIDKey, userID)，然后conn.SetContext(ctx) - 读消息时用
conn.Context().Value(userIDKey)取值，别依赖闭包捕获的局部变量 - 写消息前检查
conn.IsClosed()，避免向已断开连接发数据触发write: broken pipe
心跳与自动重连配合不好，连接会在 30 秒内静默断开
Gorilla 默认不发心跳，Nginx 或云负载均衡器会在 60 秒无数据时主动断连。你得自己管：服务端每 25 秒发一次 Ping，客户端收到自动回 Pong；同时客户端也要定时检测连接状态，失败后走重连逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 服务端启用：
conn.SetPingHandler(conn.PongHandler())，再起 goroutine 定时调conn.WriteMessage(websocket.PingMessage, nil) - 客户端用
WebSocket.onclose监听断连，延迟 1–3 秒后调new WebSocket(url)，别用指数退避——微服务发现机制通常能快速返回新 endpoint - 注意
SetReadDeadline()和SetWriteDeadline()必须每次读/写前重置，否则超时后连接直接失效
