net/http 的 upgrader.upgrade() 必须在 handler 内同步调用，因其会接管 tcp 连接，若 responsewriter 已写入或 handler 返回则连接可能被关闭，导致 “connection has been hijacked” 错误；异步调用或复用 responsewriter 均不合法。
为什么 net/http 的 Upgrader.Upgrade() 必须在 handler 里调用
因为 Upgrade() 会接管底层 TCP 连接，一旦 responseWriter 被写入或 handler 返回，连接就可能被关闭或复用——这时候再 upgrade 就会报 http: connection has been hijacked。
常见错误是把 upgrade 拆到 goroutine 里异步执行，或者试图复用同一个 http.ResponseWriter 多次调用 upgrade。正确做法是：在 HTTP handler 函数体内、且仅调用一次 upgrader.Upgrade()。
- 确保 handler 没有提前写入 response（比如调用
w.WriteHeader()或w.Write()） - 升级前检查 Origin（可选但推荐）：
if r.Header.Get("Origin") != "https://yourdomain.com" { http.Error(w, "Forbidden", http.StatusForbidden); return } - 设置超时：用
upgrader.CheckOrigin = func(r *http.Request) bool { return true }可绕过检查，但生产环境应校验
如何安全地实现全服广播而不阻塞写操作
直接遍历所有 *websocket.Conn 并调用 WriteMessage() 是危险的：某个连接卡住（如网络抖动、客户端不读）会导致整个广播阻塞，其他用户消息积压。
核心思路是「连接持有权分离」：用 map 存连接，但广播时不直接 write，而是把消息发到每个连接专属的 channel，由独立 goroutine 持续消费并 write。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 每个连接启动一个写协程：
go func() { for msg := range conn.send { conn.WriteMessage(websocket.TextMessage, msg) } }() - 广播时只向所有
conn.sendchannel 发送拷贝后的消息（注意深拷贝 if needed） - 为防止 channel 堆积，设缓冲区（如
make(chan []byte, 64)），满时可选择丢弃或阻塞（推荐带超时 select）
websocket.WriteMessage() 报 write tcp: use of closed network connection 怎么办
这不是并发问题，而是连接已断开但代码仍尝试写入。WebSocket 连接关闭后，*websocket.Conn 对象不会自动置 nil，也不会 panic，但后续 write 会失败。
必须主动检测连接状态。最可靠的方式是监听读事件（哪怕只读 ping/pong）并配合 SetReadDeadline()：
- 在连接建立后立即起 goroutine：
conn.SetReadDeadline(time.Now().Add(pingPeriod))，然后conn.ReadMessage() - 捕获
websocket.IsUnexpectedCloseError()和io.EOF，触发清理逻辑 - 清理时关闭 send channel、从全局 map 删除连接、调用
conn.Close() - 写之前不做额外判断（如
conn == nil），因为即使没 close，也可能处于半关闭状态；依赖读异常兜底更健壮
群聊消息怎么区分“谁发的”和“发给谁”
服务端不需要维护“房间”概念也能做全服广播，但要支持后续扩展（如私聊、分组），建议统一用结构体封装消息，而不是裸传字符串。
例如定义：
type Message struct {
Type string `json:"type"` // "broadcast", "private", "system"
From string `json:"from"` // 用户 ID 或 nickname
To string `json:"to"` // 空字符串表示广播
Content string `json:"content"`
Time int64 `json:"time"`
}
-
Type字段决定路由逻辑，避免用 magic string 判断 -
From应由服务端生成（如连接时分配 UUID 或解析 token），不可信客户端输入 - 广播时
To留空；私聊时只推送给目标连接（需 map 查 key） - 注意 JSON 序列化性能：高频场景下预分配
bytes.Buffer+json.NewEncoder(buf).Encode(msg)比json.Marshal()略快
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
