gorilla/websocket 是 Gin 实现即时消息提醒最直接、可控性最强的选择，因其轻量稳定、无需 Socket.IO 的冗余抽象，适合系统告警等单向推送；通过 sync.Map 管理多端用户连接，配合写超时与 goroutine 并行发送，再以 channel 异步解耦 HTTP 接口与推送逻辑。
gorilla/websocket 是 Gin 实现即时消息提醒最直接、可控性最强的选择，不依赖 Socket.IO 的额外抽象层。它轻量、稳定，适合做通知类场景——比如系统告警、订单状态变更、审批待办等单向或弱交互式推送。
为什么不用 gin.WrapH + go-socket.io？
Socket.IO 封装了重连、降级、房间管理等逻辑，但通知类场景通常不需要这些：用户只关心“我收到了”，不关心“上次断线期间漏了几条”。用 go-socket.io 会引入不必要的复杂度和内存开销，且其默认广播机制无法精准控制连接生命周期，容易在高并发下堆积 goroutine。
- Socket.IO 的
server.BroadcastToRoom内部仍基于 map 遍历，没做连接健康检查，失效连接会卡住 write 操作 - 它的 session 管理和心跳逻辑与 Gin 的中间件模型耦合松散，调试困难
- 通知类消息基本是“发完即弃”，无需 ACK 或重传，
gorilla/websocket的裸连接 + 自定义 channel 中转更干净
如何让每个通知只推给指定用户？
核心是用 sync.Map 做 userID → *Client 映射，而不是存 *websocket.Conn。因为一个用户可能多端登录（Web + App），需要支持多连接并行推送。
-
Client结构里必须带UserID和Conn，同时加Sendchannel（用于解耦写入） - 注册时用
userClientsMu.Lock()写入userClients[userID][client] = true，避免并发 panic - 推送前先调
conn.WriteDeadline = time.Now().Add(5 * time.Second)，再尝试conn.WriteMessage；失败则从 map 中清理该*Client - 不要用
range userClients[userID]直接遍历写，要起 goroutine 分别处理每个 conn，防止一个卡死拖垮全部
HTTP 接口触发推送时怎么不阻塞请求？
绝对不能在 HTTP handler 里直接调 conn.WriteMessage。网络抖动或慢客户端会让整个 HTTP 请求 hang 住，QPS 断崖下跌。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 定义
type PushJob struct { UserID string; Payload []byte }，所有通知都转成 job - 启动 1–2 个长期运行的 goroutine 消费
pushChan := make(chan PushJob, 1000) - HTTP handler 只做
select { case pushChan - 消费 goroutine 里查
userClients[userID]，对每个有效*Client启动独立 goroutine 执行写入
连接太多导致 too many open files 怎么办？
每个 WebSocket 连接至少占 1 个 fd，Gin 默认不限制，Linux 默认 ulimit -n 是 1024，很容易打满。
- 部署前必须设
ulimit -n 65536，systemd service 文件里加LimitNOFILE=65536 - 服务启动时用
http.Server{ConnContext: func(ctx context.Context, c net.Conn) context.Context {...}}注册关闭钩子 - 在钩子里显式
delete(userClients[client.UserID], client)、close(client.Send)、client.Conn.Close() - 别信 GC ——
conn.ReadMessage阻塞的 goroutine 不会自动回收，必须主动 close 才能释放 fd
真正难的不是“怎么把消息发出去”，而是“怎么确保每条通知都抵达，且不拖垮服务”。连接管理、超时控制、资源清理这三块，漏掉任何一环，上线后都会在凌晨三点报警。
