gorilla/websocket 的 Upgrader 必须显式配置跨域校验和缓冲区大小：CheckOrigin 应白名单校验 Origin，Read/WriteBufferSize 建议设为 4096 或 8192；需设置 Error 回调捕获升级错误；必须采用 readPump/writePump 并发模型保障连接保活。
gorilla/websocket 的 Upgrader 配置必须显式处理跨域和缓冲区
生产环境直接用 CheckOrigin: func(r *http.Request) bool { return true } 会引发 CORS 拒绝或被安全策略拦截，前端连握手都失败。这不是“先跑起来再说”的问题，而是连接根本建不起来。
缓冲区大小不匹配会导致消息截断或 panic：比如客户端发 2KB 消息，但 ReadBufferSize 只设 1024，conn.ReadMessage() 就会报 websocket: bad write message type 或直接丢帧。
-
CheckOrigin应校验r.Header.Get("Origin")是否在白名单内，开发期可用strings.HasSuffix(r.Header.Get("Origin"), ".example.com") -
ReadBufferSize和WriteBufferSize建议设为 4096 或 8192，避免小包频繁拷贝；若业务含大文件传输（如 base64 图片），需同步调大并启用conn.SetReadLimit() - 务必设置
upgrader.Error回调捕获升级阶段错误，否则 400/403 类错误静默吞掉，前端只看到WebSocket connection to 'ws://...' failed
连接不能裸写 for { ReadMessage() }，必须拆成 readPump/writePump 并发模型
单 goroutine 串行读写会卡死：一旦 conn.WriteMessage() 阻塞（比如网络抖动、客户端断连未及时通知），整个连接就 hang 住，既不能收新消息，也无法发心跳。
真实场景下，每个 *websocket.Conn 必须绑定两个独立 goroutine：readPump 专责读 + 转发到 hub，writePump 从 channel 拉消息发出去 —— 这不是优化项，是保活底线。
立即学习“go语言免费学习笔记（深入）”；
-
readPump中遇到err != nil时，应触发hub.unregister ，而非仅 <code>break，否则连接泄漏 -
writePump的 send channel 容量建议设为 256，太小易满导致写协程阻塞，太大则内存积压；配合conn.SetWriteDeadline()防止无限等待 - 不要在
readPump里直接调conn.WriteMessage()做回声，这违反分离原则，也掩盖了写失败的真实路径
广播性能瓶颈不在网络，而在 map 遍历和并发写竞争
当在线用户超 5000，用原始 for conn := range clients { conn.WriteMessage(...) } 会明显拖慢响应，CPU 火焰图显示 70% 时间花在 map 迭代和 mutex 争抢上。
gorilla/websocket 本身不提供广播原语，所有“群发”逻辑都得自己实现，而 naive 实现就是性能杀手。
- 用
sync.Map替代普通map[*websocket.Conn]bool，读多写少场景下减少锁开销 - 广播前先做浅拷贝：把活跃连接指针切片（
[]*websocket.Conn）一次性取出，再遍历发送，避免边读边锁 - 对高扇出场景（如通知类消息），考虑用
fan-out channel+ worker pool 分流，而不是单 goroutine 硬扛
心跳必须由服务器主动 Ping，且超时判定要分层
只依赖客户端 Pong 响应是靠不住的：NAT 超时、代理静默丢包、移动端休眠都会让连接“假活”。服务器不主动探活，半小时后才发现断连是常态。
conn.SetPingHandler() 只是注册回调，真正保活靠的是定时 conn.WriteMessage(websocket.PingMessage, nil)。
- 心跳间隔建议 25s，略小于常见 NAT 超时（30s），避免被中间设备掐断
- 超时判定不能只看一次
Pong缺失：应维护 per-connection 的连续丢失计数，3 次无响应再 close，防止误杀 - 务必在
writePump中集成心跳逻辑，否则写通道阻塞时 Ping 发不出去，心跳机制形同虚设
实际部署时最常被忽略的是连接关闭后的资源清理时机：defer conn.Close() 只保证函数退出时关连接，但若客户端异常断网，ReadMessage() 返回 io.EOF 或 net.OpError 后，goroutine 退出前必须确保从 hub unregister、清空 send channel、关闭 done channel —— 少一步，内存和 goroutine 就持续泄漏。
