gorilla/websocket 是 Go 生态中事实标准的 WebSocket 实现，因标准库不支持 WebSocket，http.Server 仅负责握手升级，后续二进制帧通信必须由专门库处理；常见错误包括未 Upgrade 就读消息、未分离读写 Goroutine、CheckOrigin 默认拒绝跨域、Dialer URL 协议或超时配置不当。
gorilla/websocket 是 Go 生态中事实标准的 WebSocket 实现，标准库不支持 WebSocket，别试图用 net/http 原生处理帧——它只负责握手升级，后续通信必须交给专门库。
为什么 http.Server 不能直接处理 WebSocket 消息
HTTP 长连接（keep-alive）和 WebSocket 是两回事：http.Server 的 Handler 函数在一次请求生命周期结束后就退出，连接可能复用，但无法持续监听或主动推送。WebSocket 握手完成后，TCP 连接脱离 HTTP 协议栈，进入二进制帧通信阶段，http.ResponseWriter 和 *http.Request 已失效。
常见错误现象：
- 在
http.HandleFunc里调用conn.ReadMessage()前没做Upgrade，报unexpected EOF或connection closed - 升级后没启动独立 Goroutine 循环读写，只读一次就 return，连接立刻断开
- 误以为
http.ServeMux能路由 WebSocket 子协议，实际只能路由到升级入口路径
Upgrader.CheckOrigin 不设为 true 就跨域失败
浏览器发起 WebSocket 连接时，会携带 Origin 头。默认情况下 gorilla/websocket 的 CheckOrigin 返回 false，拒绝所有非同源请求——这不是安全加固，是默认保守策略。
立即学习“go语言免费学习笔记（深入）”；
开发阶段快速验证可设为：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
var upgrader = websocket.Upgrader{
CheckOrigin: func(r *http.Request) bool { return true },
}生产环境必须显式校验：
- 从
r.Header.Get("Origin")提取域名，白名单比对 - 避免用
strings.Contains简单匹配，防止evil.com.example.com绕过 - 若前端部署在
https://app.example.com，则只放行该 Origin
读写必须在不同 Goroutine 中持续运行，否则连接秒断
conn.ReadMessage() 和 conn.WriteMessage() 都是阻塞调用。如果只在一个 Goroutine 里顺序执行“读→处理→写”，第二次读就会卡住，因为写操作可能因网络延迟未完成，而连接已超时关闭。
正确做法是分离读写逻辑：
- 主 Goroutine 启动后立即
go readPump(conn)和go writePump(conn) -
readPump专注循环ReadMessage，收到消息后发到 channel -
writePump从 channel 取消息，循环WriteMessage，注意加锁或用conn.SetWriteDeadline - 任一环节出错（如
io.EOF、websocket.CloseMessage），需通知对方并conn.Close()
漏掉 Goroutine 分离，90% 的 “连接收一条消息就断” 问题都源于此。
websocket.DefaultDialer 客户端连不上？检查 URL 协议和端口
客户端用 websocket.DefaultDialer.Dial("ws://localhost:8080/ws", nil) 失败，常见原因不是代码逻辑，而是 URL 格式或服务状态：
-
ws://对应 HTTP 服务，wss://必须配 TLS；混用会直接报dial tcp: lookup或bad handshake - 本地测试时，
localhost和127.0.0.1在某些系统 DNS 解析行为不同，建议统一用127.0.0.1 - 服务端没监听
:8080，或防火墙拦截；先用curl -i http://127.0.0.1:8080/ws看是否返回101 Switching Protocols - 浏览器客户端连不上，多半是服务端
CheckOrigin拒绝，而非 URL 错误
真正容易被忽略的是：WebSocket 连接建立后，底层 TCP 连接不再受 HTTP 超时控制，但 DefaultDialer 自身有默认 45 秒握手超时，大延迟网络下需手动设置 HandshakeTimeout。
