GoLand 的 Run/Debug 按钮不能测 WebSocket 长连接，因其仅启动服务端监听 HTTP 端口，不模拟客户端发起 new WebSocket() 请求，也不维持 TCP 连接；http.HandleFunc 仅处理一次握手升级，后续二进制帧通信需真实外部客户端（如 wscat）触发，否则 conn.ReadMessage() 将阻塞等待数据。
GoLand 本身不提供 WebSocket 连接测试界面，必须靠写代码 + 启动服务 + 外部客户端（如浏览器、wscat、Postman）完成真实长连接交互验证；直接在 GoLand 里点“Run”只会跑 HTTP handler，不会维持连接。
为什么 GoLand 的 Run/Debug 按钮不能测 WebSocket 长连接
GoLand 的调试器启动的是 main() 函数并监听 HTTP 端口，但它不模拟客户端发起 new WebSocket("ws://...") 请求，更不会保持 TCP 连接存活。你看到的“程序运行中”只是服务端进程活着，不代表有 WebSocket 连接建立或消息收发。
-
http.HandleFunc或 Gin 的GET("/ws")只响应一次握手请求，之后连接就脱离 HTTP 生命周期 —— GoLand 不会自动跟进 - 如果你在 handler 里写了
conn.ReadMessage()却没配外部客户端，程序会卡在那行阻塞读，调试器看似“停住”，实则是等待根本不存在的数据 - 所有心跳、Ping/Pong、并发读写逻辑，都依赖真实连接存在，GoLand 自身不构造这个前提
在 GoLand 中快速验证真实 WebSocket 交互的三步法
核心是：用 GoLand 写+编译+启服务，用轻量外部工具连，用日志和断点观察行为。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确保服务代码里有明确日志：在
upgrader.Upgrade()成功后打一行log.Println("client connected:", r.RemoteAddr)，失败时也打印err - 终端里用
wscat -c ws://localhost:8080/ws（需先npm install -g wscat）—— 它能建真实连接、发消息、看回包，且支持 Ctrl+C 断开 - GoLand 调试时，在
conn.ReadMessage()和conn.WriteMessage()行设断点，wscat 发消息后，调试器会真正停住并显示变量值，这才是真实交互时刻 - 别依赖 GoLand 控制台输出判断连接状态：
conn.Close()可能静默失败，要结合err != nil判断，日志里补上log.Println("client disconnected:", err)
常见连不上 / 握手失败的 GoLand 调试线索
不是代码写错了，而是环境或配置挡在了第一步。优先查这些：
- 浏览器控制台报
WebSocket connection to 'ws://...' failed: Error during WebSocket handshake→ 检查 GoLand 启的服务是否真在跑（curl -i http://localhost:8080/ws应返回101 Switching Protocols，不是 404 或 500） - GoLand 日志出现
http: response.WriteHeader on hijacked connection→ 说明你在upgrader.Upgrade()前往http.ResponseWriter写了任何东西（包括fmt.Fprint(w, "...")或中间件提前写了 header），删掉 - wscat 连接后立刻断开，日志无
client connected→CheckOrigin拒绝了请求，默认返回false；临时改成return true排查，生产再改回来 - 用 Postman 测 WebSocket？别费劲 —— 它的 WebSocket 功能仅限新版桌面版（v10.20+），且不支持自定义 header（比如带
Authorization），不如 wscat 直接
心跳和超时问题在 GoLand 里怎么确认生效
心跳不是“开了就保活”，它依赖 Deadline + 主动 Ping + Pong 响应三者配合。只靠 GoLand 日志看不出是否真起作用：
- 在
conn.SetReadDeadline()后加一行log.Printf("read deadline set to %v", time.Now().Add(30*time.Second))，确认时间确实设进去了 - 在
SetPongHandler回调里打日志：log.Println("received pong, resetting deadline")—— 如果 wscat 连着但这条日志不出现，说明客户端根本没发 pong（可能是前端没调ws.onmessage处理 ping 帧） - 手动触发超时：用 wscat 连上后，直接关掉终端（模拟网络断开），等 30 秒以上，看服务端日志是否打出
i/o timeout并执行conn.Close() - 注意：GoLand 的 Debug 模式可能让 goroutine 调度变慢，心跳 ticker 间隔设太短（如 1s）会导致日志刷屏或误判，开发期用 10s 更稳
真实长连接的“真实”体现在操作系统级的 TCP 连接持续存在，而不是 GoLand 界面有没有绿色运行按钮。每次怀疑连接异常，第一反应不应该是重跑 GoLand，而是用 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows）看端口下到底有几个 ESTABLISHED 状态的连接 —— 这个数字，才最接近真相。
