搭建Golang环境并编写首个WebSocket服务端-Golang-PHP中文网

go 1.21+ 安装后 go 命令找不到，根本原因是 path 未包含 $goroot/bin；需确认 $goroot 指向正确安装路径（如 /usr/local/go），并将 $goroot/bin 加入 path，macos/linux 用户须 source ~/.zshrc 等配置文件，windows 用户需检查安装时是否勾选“add go to path”。

搭建golang环境并编写首个websocket服务端

Go 1.21+ 安装后 `go` 命令找不到？检查 `$PATH` 和 `$GOROOT`

安装 Go 后运行 go version 报错“command not found”，大概率是环境变量没生效。macOS/Linux 用户常漏掉 source ~/.zshrc（或 ~/.bash_profile）；Windows 用户需确认是否勾选了“Add Go to PATH”——手动安装 ZIP 包时这个选项默认不启用。

验证方式：运行 echo $GOROOT（应输出类似 /usr/local/go），再执行 echo $PATH | grep go 看路径是否包含 $GOROOT/bin。若没有，追加 export PATH=$GOROOT/bin:$PATH 到 shell 配置文件并重载。

用 `gorilla/websocket` 而不是标准库写 WebSocket 服务？标准库不支持完整协议

Go 标准库 net/http 可处理升级请求，但不提供 WebSocket 帧解析、心跳、连接管理等能力。直接用它写服务端极易出错：比如忽略 CloseMessage 导致连接泄漏，或未正确响应 ping/pong 被客户端断连。

推荐直接使用 gorilla/websocket——它仍是当前最稳定、文档最清晰的第三方实现：

初始化连接用 upgrader.Upgrade(w, r, nil)，别漏掉 nil 参数（实际可传 http.Header 控制 CORS）
conn.SetReadDeadline 和 conn.SetWriteDeadline 必须显式设置，否则空闲连接会卡死
读写操作必须配对：每个 conn.ReadMessage() 后最好跟 conn.WriteMessage() 或明确错误处理，避免 goroutine 积压

启动服务后浏览器连不上 `ws://localhost:8080/ws`？检查跨域和升级头

常见现象：控制台报错 WebSocket connection to 'ws://localhost:8080/ws' failed，服务端无日志。大概率是客户端发的 Upgrade 请求被中间件拦截，或服务端未正确返回 101 Switching Protocols。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

排查步骤：

用 curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" http://localhost:8080/ws 模拟握手，看是否返回 101 状态码
若返回 400/500，检查 upgrader.CheckOrigin 是否拒绝了 localhost——开发时可临时设为 func(r *http.Request) bool { return true }
前端 JS 连接时确保 URL 协议匹配：HTTP 页面不能连 ws://（需 http://），HTTPS 页面不能连 ws://（需 wss:// 或同源）

消息广播时 panic: concurrent write to websocket connection？别在多个 goroutine 里直接 `conn.WriteMessage`

WebSocket 连接不是线程安全的：conn.WriteMessage() 内部会锁住底层 writer，但并发调用仍可能触发 panic。典型场景：一个 goroutine 处理读、另一个 goroutine 定时广播、第三个 goroutine 响应其他事件——全往同一个 conn 写就会崩。

解决方案只有一个：所有写操作必须串行。常用模式是给每个连接配一个 chan []byte，另起 goroutine 从 channel 消费并调用 WriteMessage：

func (c *Client) writePump() {
    for msg := range c.send {
        if err := c.conn.WriteMessage(websocket.TextMessage, msg); err != nil {
            break
        }
    }
    c.conn.Close()
}

注意：channel 关闭前要先 close(c.send)，否则 range 永不退出；发送方写 channel 前务必检查 c.send 是否已关闭（可用 select + default 避免阻塞）。

WebSocket 不是 HTTP，连接生命周期长、状态管理复杂。哪怕只是 echo 服务，也要立刻处理 close、ping、error 三类事件——漏掉任意一个，上线后都会变成连接数缓慢上涨的内存泄漏。