一个可用的WebSocket聊天室需守住连接、广播消息、处理断开三件事：用gorilla/websocket升级连接并设读写超时与心跳，用sync.RWMutex保护map管理客户端，广播时跳过发送者，配置CORS和反向代理以支持生产部署。
Go 语言写一个可用的 WebSocket 聊天室，核心不在于“炫技”，而在于守住连接、广播消息、处理断开这三件事。用 gorilla/websocket 是最稳妥的选择，标准库的 net/http + websocket（1.22+）也能跑，但生产环境建议直接上 gorilla。
用 gorilla/websocket 建立基础连接和心跳
客户端连上来时，必须立刻升级 HTTP 连接，并设置合理的读写超时与心跳机制，否则连接会在 30–60 秒后被代理或浏览器静默关闭。
常见错误：只调用 upgrader.Upgrade() 就开始读消息，没设 SetReadDeadline，结果客户端断网后服务端长期卡在 conn.ReadMessage() —— 这会拖垮 goroutine 数量。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在
Upgrade后立即调用conn.SetReadDeadline(time.Now().Add(pongWait))，并在每次收到pong后重置 - 启动一个单独 goroutine 调用
conn.WriteMessage(websocket.PingMessage, nil)，间隔设为pingPeriod = (pongWait * 9) / 10 - 捕获
websocket.CloseMessage和io.EOF，主动调用conn.Close()并从广播池中移除该连接
用 map + mutex 管理在线连接，避免竞态
很多人直接用 map[*websocket.Conn]bool 存连接，但并发读写会 panic。gorilla 示例里用 sync.RWMutex 包一层是最低成本解法。
注意点：
- 不要在广播循环里直接遍历 map —— 如果某个
conn.WriteMessage()阻塞或失败（比如客户端已断），不加 recover 会导致整个广播中断；应逐个写并忽略websocket.ErrCloseSent和io.ErrUnexpectedEOF - 连接 ID 最好用自增 int 或
uuid.NewString()，别用conn.RemoteAddr().String()，NAT 或反向代理后地址会重复 - map 的 key 类型推荐
string（ID），value 存结构体，包含*websocket.Conn、joinTime time.Time、username string，方便后续扩展
消息广播必须区分“发给所有人”和“发给自己除外”
前端发一条消息，后端默认要广播给其他所有人，但不能回推给自己——否则会出现两次重复消息。这个逻辑不在前端做，必须由服务端控制。
典型场景：
- 用户 A 发送
{"type":"msg","text":"hi"}，服务端解析后构造带时间戳和用户名的对象，再发给除 A 外所有在线连接 - 系统通知（如“用户 B 加入聊天室”）才需要广播给全部人，包括刚连上的 B
- 如果用了 JSON 消息，务必统一字段名，比如固定用
data包裹内容，避免前端反复判断text/message/content
示例广播片段（简化）：
for id, client := range clients {
if id == senderID { // 跳过自己
continue
}
if err := client.conn.WriteJSON(map[string]interface{}{
"type": "broadcast",
"from": senderName,
"data": msgText,
"ts": time.Now().UnixMilli(),
}); err != nil {
log.Printf("write to %s failed: %v", id, err)
delete(clients, id)
client.conn.Close()
}
}静态资源托管和 CORS 配置常被忽略
本地开发时前端用 file:// 或 Vue/React dev server，WebSocket 连接容易因跨域被浏览器拒绝，报错类似 WebSocket connection to 'ws://localhost:8080/ws' failed，但实际不是 WebSocket 协议问题，而是 HTTP 握手阶段被拦。
解决方式：
- 在
gorilla/websocket.Upgrader中显式设置CheckOrigin: func(r *http.Request) bool { return true }（仅开发用） - 生产环境改用 Nginx 反向代理 WebSocket，配置
proxy_http_version 1.1和proxy_set_header Upgrade $http_upgrade - 前端 HTML 和 JS 建议直接用
http.FileServer托管，路径如/static/，避免额外启服务导致跨域复杂化
真正难的不是写完能跑，而是当 50 个连接同时发消息、有人频繁断线重连、后台日志混着 read/write timeout 和 closed network errors 时，你能否快速定位是连接管理漏了 close，还是广播没做 error skip，或是心跳周期配反了。这些细节藏在日志和压测里，不在代码行数里。
