不能直接在gin handler中调用upgrade后发消息，因为handler短生命周期导致conn变量失效，必须由独立goroutine长期托管；跨实例广播需redis pub/sub中继，单机chan和map无法跨节点通信。
直接用 gorilla/websocket 就行，别套框架——Gin/echo 等 HTTP 框架对 WebSocket 的支持只是“转发请求”，真正连接管理、广播逻辑必须自己写，套进去反而容易绕晕。
为什么不能直接在 Gin 的 handler 里调 Upgrader.Upgrade() 后就发消息？
因为 Upgrade 后的 *websocket.Conn 是长生命周期对象，而 Gin 的 handler 是短生命周期的：请求一结束，handler 函数栈就销毁，你存的连接变量（比如局部 conn）立刻失效。所有后续读写都得靠 goroutine 持有引用并持续运行。
常见错误现象：panic: send on closed channel 或 use of closed network connection，本质是把连接当一次请求处理完了，没做长期协程托管。
- Upgrade 只是协议切换动作，不是连接终点；它返回的
conn必须立刻交给独立 goroutine 管理 - 不要在 handler 里调
conn.WriteMessage()广播——此时其他连接还没注册，也无并发保护 - 跨域配置（
CheckOrigin）必须设好，否则浏览器连不上，错误是ERR_CONNECTION_REFUSED或静默失败
hub 结构体里为什么必须用 sync.RWMutex 而不是普通 map？
因为 clients map 会被多个 goroutine 同时访问：readPump 注册时写、writePump 断连时写、broadcast 协程遍历时读。Go 的原生 map 并发读写直接 panic。
性能影响很实际：不用锁，50 个并发连接就大概率 crash；加了 RWMutex，读多写少场景下几乎无感——广播是高频读，注册/注销是低频写。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 读操作（如遍历广播）用
RLock()/RUnlock()，允许多个 reader 并发 - 写操作（如
register/unregister）用Lock()/Unlock()，排他 - 别图省事用
sync.Map——它适合 key 随机分布、读写极不均衡的缓存场景，不适合需要遍历全部 value 的广播逻辑
广播协程里调 conn.WriteMessage() 前为什么要设 SetWriteDeadline()？
TCP 连接断开时，服务端可能很久收不到 FIN 包（比如客户端突然关机、网络中断），WriteMessage() 就会无限阻塞，卡死整个广播循环，导致所有用户消息积压、延迟飙升。
典型错误现象：新消息发不出，后台日志停在某次 write，CPU 却不高——就是被一个僵死连接拖住了。
- 必须在每次写前调
conn.SetWriteDeadline(time.Now().Add(5 * time.Second)) - 检查返回 error：遇到
websocket.ErrCloseSent或io.EOF，立即关闭该conn并从clients移除 - 不要依赖心跳包来发现断连——心跳只能辅助，write deadline 是最后一道防线
生产环境部署多实例时，broadcast channel 还管用吗？
完全不管用。chan 是进程内通信机制，A 实例的 broadcast channel 对 B 实例不可见。Nginx 负载均衡后，用户随机落在不同节点，A 节点用户发的消息，B 节点用户永远收不到。
这时候必须换 Redis Pub/Sub，但注意：Redis 不替代本地 clients map，只解决“消息怎么跨节点传”。每个节点仍要独立维护自己的在线连接列表，并用自己的 writePump 发送。
- 客户端消息入口（readPump）不再往本地
broadcastchannel 写，而是client.Publish(ctx, "ws:global:broadcast", msg) - 每个节点起一个 goroutine
Subscribe("ws:global:broadcast")，收到后走本地广播流程 - Redis 连接必须加
context.WithTimeout，避免网络抖动导致 goroutine 永久挂起
最容易忽略的一点：上线人数超过 300 且部署 ≥2 实例时，单机广播模型已失效，不是“优化问题”，是架构断点——必须切 Redis，晚切一天，线上就会丢消息。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
