应为每个频道维护独立连接池并配专属写goroutine；复用Upgrader安全，但混存连接会导致误播；需绑定频道名到context、关闭时清理map和conn；并发WriteMessage会panic。
如何用 gorilla/websocket 正确管理多个频道连接
直接复用单个 websocket.Upgrader 实例是安全的，但每个频道必须独立维护客户端连接池——不能把不同频道的 *websocket.Conn 混存在同一个 map 里还靠 client ID 区分。否则广播时极易发错频道。
- 为每个频道（如
"english-beginner"）分配独立的map[*websocket.Conn]bool，避免锁竞争和误播 - 连接建立后立刻绑定频道名到 context，用
context.WithValue(r.Context(), channelKey, "spanish-intermediate")，别依赖 URL 参数或 query string 做后续路由判断 - 关闭连接时务必从对应频道的 map 中删除，并调用
conn.Close()，否则 goroutine 泄漏+内存持续增长
为什么 conn.WriteMessage() 在并发写入时 panic
WebSocket 连接不支持并发写。哪怕只是两个 goroutine 同时调用 conn.WriteMessage()，就会触发 write tcp: use of closed network connection 或直接 panic。
- 每个
*websocket.Conn必须配一个专属的写入 goroutine，接收来自频道广播 chan 的消息 - 不要在 handler 里直接
WriteMessage()，改用select { case c.send 把消息推入带缓冲的 <code>chan []byte - 缓冲区大小建议设为 32–64，太小易阻塞，太大浪费内存且掩盖设计缺陷
如何让语言学习场景下的消息低延迟又不丢
语音跟读、实时翻译提示这类功能对延迟敏感，但又不能牺牲可靠性。原生 websocket.TextMessage 不够用，得自己加轻量级序列化与重传逻辑。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用
encoding/json序列化结构体（如{Type: "pronounce", Text: "hello", Timestamp: 1717023456}），别传裸字符串 - 给每条业务消息加单调递增的
SeqID int64字段，客户端收到后比对上一条，缺失则主动发{"type":"req-miss","from":123,"to":125} - 服务端不实现完整 ACK，只缓存最近 20 条已发消息（按 SeqID 索引），收到重传请求就回发，超时或超出范围则返回空
HTTP 路由与 WebSocket 升级路径怎么共存不冲突
常见错误是把 http.HandleFunc("/ws", wsHandler) 和 http.HandleFunc("/api/lessons", lessonHandler) 直接注册，结果发现 /ws 总返回 404 或升级失败。
立即学习“go语言免费学习笔记（深入）”；
-
Upgrader.CheckOrigin默认拒绝所有跨域请求，开发阶段必须显式设为func(r *http.Request) bool { return true }，上线再按域名白名单收紧 - 确保
/ws路由在其他中间件（如 JWT 验证、gzip 压缩）之后执行，否则r.Header可能被篡改导致Upgrade头丢失 - 不要在
wsHandler里调用http.Error()或写 response body，升级成功后 HTTP 连接已转为 WebSocket，任何 write 都会 panic
实际部署时最容易忽略的是连接空闲超时。浏览器 tab 切走后，net.Conn 可能还在，但客户端已不再读取。记得在 Upgrader 上设置 HandshakeTimeout 和 ReadTimeout，并配合心跳帧清理僵死连接。
