GoLand调试WebSocket失败主因是监听地址、Upgrade调用时机、断点设置及Nginx配置错误：需改代码为0.0.0.0:8080，Upgrade前禁写响应，分阶段设断点，Nginx补全Upgrade/Connection头。
GoLand 启动时没监听 0.0.0.0，前端连不上
GoLand 默认用 go run 启动服务，但如果你的 main.go 里写的是 http.ListenAndServe("localhost:8080", nil)，那服务只绑在 127.0.0.1 —— 手机浏览器、Docker 容器、甚至某些 IDE 内置预览页都访问不到。
调试时务必改成：http.ListenAndServe("0.0.0.0:8080", nil)。别改 GoLand 的 Run Configuration，直接改代码；否则容易误以为是 IDE 配置问题，实际是绑定地址不对。
- 检查 GoLand 的 Run → Edit Configurations… → Program arguments 是否为空（它不干预监听地址）
- 启动后在终端执行
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows），确认监听的是*:8080或0.0.0.0:8080，不是127.0.0.1:8080 - 前端 URL 必须是
ws://127.0.0.1:8080/ws或ws://localhost:8080/ws，不能是http://—— Chrome 控制台 Network 标签里看不到Sec-WebSocket-Key就说明根本没发升级请求
断点卡在 Upgrade 前，但连接始终 pending
upgrader.Upgrade() 是阻塞调用，它内部会 hijack HTTP 连接、写响应头、切换协议。如果在这之前你往 w 写了任何东西（比如 w.WriteHeader(200)、fmt.Fprint(w, "...")，甚至一个空格或换行），Go 的 http 包会 panic 报 http: response.WriteHeader on hijacked connection，而 GoLand 默认不显示这种底层 panic，只让请求卡住或返回 500。
确保 upgrader.Upgrade() 是 handler 里**第一个可能产生响应的操作**：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 删掉所有
w.Header().Set(...)、w.WriteHeader(...)、json.NewEncoder(w).Encode(...)等提前写响应的代码 - 校验逻辑（如 token 解析、Origin 检查）必须在
Upgrade()之前完成，但不能触发写响应 - 错误处理要早于
Upgrade()：比如if !validToken(r) { http.Error(w, "Unauthorized", 401); return }
调试时 goroutine 泄漏，断点进不去后续读写逻辑
WebSocket 连接建立后，conn.ReadMessage() 和 conn.WriteMessage() 都是阻塞调用。如果你在 GoLand 里只在 for 循环开头打了一个断点，然后暂停 —— 那读协程就卡在 ReadMessage() 上，写协程可能还没启，或者也卡在 WriteMessage()，整个连接处于“半活”状态，GoLand 的 Debug 视图里会堆满僵尸 goroutine。
正确做法是分阶段设断点：
- 第一处：在
upgrader.Upgrade()成功后立即设断点，确认conn不为 nil - 第二处：在
for循环内conn.ReadMessage()**之后**设断点，等收到消息再停 - 第三处：在
conn.WriteMessage()**之后**设断点，确认发送成功 - 避免在
ReadMessage()调用行本身打断点 —— 它没返回你就停不住，IDE 会假死
用了 Nginx 代理，GoLand 调试时 WebSocket 直接 400
GoLand 本地调试通常直连 Go 服务，但如果项目配置了 Nginx（比如 nginx.conf 在项目根目录，且你习惯用 nginx -s reload 测试），而 Nginx 配置里漏了两个关键 header，浏览器发来的 Upgrade 请求就会被拒绝，返回 400 Bad Request。
检查你的 Nginx 配置段是否包含这两行（尤其注意大小写和引号）：
proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";- 如果用了
proxy_pass http://127.0.0.1:8080;，确保后端 Go 服务监听的是127.0.0.1:8080（而非0.0.0.0），否则 Nginx 可能连不上 - GoLand 调试时建议先绕过 Nginx：把前端 URL 改成
ws://localhost:8080/ws，确认纯 Go 服务能通，再排查代理层
conn.SetReadDeadline()，断点停太久，连接就被底层 TCP 自动断开，再继续单步时 ReadMessage() 直接返回 io.EOF，你以为是逻辑错，其实是超时了。 
