websocket连接管理必须用websocket.conn指针，值传递会导致io缓冲区失效、报broken pipe错误；房间路由需用map[string]map[websocket.conn]bool隔离，消息须含lang/level字段校验，断连时须主动清理map并广播leave事件。
WebSocket连接管理必须用指针传递*websocket.Conn
直接传websocket.Conn值类型会导致连接被复制，底层IO缓冲区、状态机和读写锁全部失效，客户端一发消息就报write: broken pipe或read: use of closed network connection。所有 handler 函数签名里，conn参数必须是*websocket.Conn。
常见错误写法：func handle(conn websocket.Conn) → 立刻崩溃；正确写法：func handle(conn *websocket.Conn)。Go 的 gorilla/websocket 库内部对连接对象做了大量同步封装，值传递会绕过这些保护机制。
- 初始化连接时用
upgrader.Upgrade(w, r, nil)返回的就是*websocket.Conn，别再解引用 - 把连接存进 map 时，key 可以是用户 ID 或房间 ID，value 必须是
*websocket.Conn，不是websocket.Conn - 广播消息前检查
conn != nil && conn.IsClosed() == false，因为关闭后指针仍非 nil
多房间路由靠map[string]map[*websocket.Conn]bool而非全局广播
一个房间对应一个map[*websocket.Conn]bool，外层用房间名（如"es-101"）做 key。别用单个全局 map 存所有连接——那样无法隔离消息，也无法按房间清理资源。
典型误操作：收到消息后遍历所有连接广播；正确做法是先从 URL 路径或首帧 JSON 解析出roomID，再查对应房间的连接集合。比如 WebSocket 连接 URL 是wss://chat.example.com/ws?room=ja-202，就得在Upgrade前从r.URL.Query().Get("room")提取。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 房间 map 初始化要加锁，建议用
sync.Map或sync.RWMutex保护外层map[string]... - 用户进房时，往对应房间 map 插入
conn: true；退房或断连时，必须从该房间 map 中删除，否则内存泄漏 - 广播时用
for conn := range roomConns，别用range遍历后存 slice 再发——并发写可能 panic
语言学习场景下，消息结构必须带lang和level字段
单纯传{"text": "hello"}不够。语言学习需要上下文：目标语种、难度等级、是否启用纠错、是否需要翻译回显。服务端不解析这些字段，就无法做后续路由（比如把日语 N5 消息只推给同级别用户）或触发 AI 辅助逻辑。
推荐最小消息格式：{"type":"message","room":"zh-301","lang":"zh","level":3,"text":"你好"}。前端发消息前必须填全，后端校验lang是否在白名单（如[]string{"en","ja","ko","zh"}），level是否为 1–5 整数。
- 如果
lang非法，直接conn.WriteMessage(websocket.TextMessage, []byte(`{"error":"unsupported lang"}`))并 return -
level用于房间准入控制：用户加入"ja-401"时，检查其 profile.level >= 4，否则拒绝 - 避免在消息体里嵌套复杂结构（如带语法标注的富文本），先走纯文本，扩展用自定义 message type 字段区分
连接断开时必须主动清理房间 map 和发送 leave 事件
仅靠defer conn.Close()不够。客户端网络闪断、浏览器标签关闭、手机切后台都会让连接静默断开，conn.ReadMessage() 返回io.EOF或websocket.CloseMessage才是唯一可靠信号。
必须在读循环里捕获这些错误，然后执行三件事：从房间 map 删除该连接、向同房间广播{"type":"leave","user_id":"u_123"}、关闭连接。漏掉任何一步，就会出现“人已走但头像还挂着”或“新用户进房收不到历史成员列表”等问题。
- 读循环模板：用
for { msgType, msg, err := conn.ReadMessage()，遇到err != nil先判断websocket.IsUnexpectedCloseError(err, ...) - 清理房间 map 前，先用
mutex.Lock()锁定，删完再Unlock()，防止并发写 panic - 广播
leave事件时，别忘了排除自己——否则用户会看到自己“退出房间”，体验奇怪
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
