go标准库无原生websocket实现，gorilla/websocket是事实标准；需用两个goroutine分别处理读写并加deadline；心跳需手动定时ping+pong响应+超时关闭；须用context控制goroutine生命周期并注意conn.close()调用时机。
为什么直接用 gorilla/websocket 而不是标准库
Go 标准库没有原生 WebSocket 实现，net/http 只提供底层升级（upgrade）支持，但握手、帧解析、ping/pong、错误重连这些都得自己写。实际项目里几乎没人从零实现，gorilla/websocket 是事实标准——它稳定、文档全、被大量生产系统验证过，且 API 清晰。
注意：gorilla/websocket 已归档，但仍在维护；新项目可考虑 gobwas/ws 或 nhooyr.io/websocket，不过迁移成本高，除非有明确需求（比如需要更细粒度控制或更低内存占用），否则继续用 gorilla/websocket 更稳妥。
如何正确处理连接生命周期和并发读写
WebSocket 连接是双向的，ReadMessage 和 WriteMessage 都是非线程安全的，不能在多个 goroutine 里同时调用同一个连接的读或写方法。常见错误是：一个 goroutine 在读消息，另一个 goroutine 同时发心跳，结果触发 concurrent write to websocket connection panic。
- 必须为每个连接启动两个 goroutine：一个专读（
conn.ReadMessage），一个专写（conn.WriteMessage） - 写操作统一走 channel（如
chan []byte），由 writer goroutine 串行消费，避免并发写 - 读 goroutine 收到消息后，应通过 channel 或回调分发给业务逻辑，不要直接在读 goroutine 里做耗时操作（比如 DB 查询、HTTP 请求）
- 务必设置
conn.SetReadDeadline和conn.SetWriteDeadline，否则超时连接不会自动断开，容易堆积
如何设计心跳与连接保活机制
客户端可能静默掉线（比如手机切后台、网络中断），服务端无法感知，导致连接假死。单纯依赖 TCP keepalive 不够，因为中间设备（NAT、代理）常会提前关闭空闲连接。
gorilla/websocket 提供了 SetPingHandler 和 SetPongHandler，但默认不自动发 ping。你需要手动定时触发：
- 在连接建立后，立即启动一个 ticker，每 30 秒调用一次
conn.WriteMessage(websocket.PingMessage, nil) - 设置
conn.SetPingHandler为nil或空函数（防止客户端 ping 时服务端自动回 pong，干扰自定义逻辑） - 客户端必须响应 pong，服务端收到 pong 后重置读超时（
conn.SetReadDeadline(time.Now().Add(60 * time.Second))） - 如果连续 2 次 ping 无响应（即 60 秒内没收到 pong），主动
conn.Close()
别依赖 websocket.DefaultPingPeriod —— 它只是示例值，不参与实际逻辑。
如何避免内存泄漏和 goroutine 泄露
每个连接对应至少 2 个长期运行的 goroutine（reader + writer）。如果连接未正常关闭（比如客户端直接断网、进程 kill），这些 goroutine 就会卡在阻塞 IO 上，永远不退出。
- 所有 goroutine 启动前，必须绑定一个
context.Context，并在连接关闭时 cancel 它 - 读 goroutine 应监听
ctx.Done()，一旦收到信号就退出循环并关闭连接 - 写 goroutine 的 channel 消费循环也要检查
ctx.Done()，且 channel 必须带缓冲（如make(chan []byte, 32)），否则 writer 卡住会导致 reader 也卡住 - 连接关闭时，先 close 写 channel，再调用
conn.Close()，最后 cancel context —— 顺序错了会导致 goroutine 等待 channel 发送而永不返回
最易忽略的一点：defer conn.Close() 放在 handler 函数开头看似保险，但如果连接已因网络问题断开，conn.Close() 会阻塞数秒（默认 timeout），拖慢整个 HTTP handler。应该只在明确要结束连接时才调用，且带上超时控制。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
