goland不内置websocket调试面板，需手动加日志、设超时、检查路由与握手、绑定正确地址并配置代理以实现有效调试。
GoLand里看不到WebSocket连接的实时收发数据
GoLand本身不内置WebSocket调试面板，net/http 或 gorilla/websocket 的底层连接流量默认不会出现在IDE界面里。你写的conn.ReadMessage()和conn.WriteMessage()调用成功了，但没日志、没断点停住、也没地方看原始帧——这很正常，不是代码错了，是工具链没对齐。
实操建议：
- 在关键读写位置手动加
log.Printf，比如log.Printf("recv: %s", message)，并确保log包已导入； - 用
conn.SetReadDeadline()和conn.SetWriteDeadline()配合超时日志，避免阻塞导致“看起来没反应”； - 不要依赖GoLand的“Console”窗口捕获所有输出——启动时勾选
Run with default console，否则部分log可能被吞掉； - 如果用了
golang.org/x/net/websocket（已弃用），立刻换成github.com/gorilla/websocket，前者不支持现代ping/pong心跳，调试时容易误判断连。
断点进不去handleWebSocket函数，但HTTP路由明明注册了
常见原因是路由复用或中间件拦截：GoLand能下断点，但请求根本没走到你的handler。比如用http.ServeMux时，路径末尾多写了/（/ws/ vs /ws），或者用了gin/echo等框架却忘了启用UseRouter()之类的基础配置。
实操建议：
- 在
http.HandleFunc或框架路由注册后，加一行log.Println("WS route registered at /ws")，确认服务启动时该行被执行； - 用
curl -i http://localhost:8080/ws测试是否返回101 Switching Protocols，不是200或404——如果不是，说明HTTP层就失败了； - 检查GoLand的Run Configuration里
Working directory是否正确，尤其当项目含go.mod时，错放路径会导致go run找不到main包； - 如果用了反向代理（如Nginx），确认它透传了
Upgrade和Connection头，否则WebSocket握手直接被降级成普通HTTP。
GoLand调试时goroutine卡住，但程序没报panic
即时通讯场景下大量goroutine常因channel阻塞、锁未释放或context取消不及时而“静默挂起”。GoLand的Debug视图能看到goroutine列表（View → Tool Windows → Debug → Goroutines），但默认只显示状态，不提示阻塞点。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
实操建议：
- 启动时加
-gcflags="-l"参数禁用内联（GoLand Run Config → Go tool arguments），让断点更准，尤其对select语句里的channel操作； - 在疑似阻塞的
select前加log.Printf("enter select, ch len: %d", len(ch))，观察channel缓冲区是否已满； - 用
runtime.Stack在特定条件下打印堆栈，例如在心跳超时回调里调用log.Printf("%s", debug.Stack())； - 别在goroutine里直接
defer conn.Close()却不检查conn.RemoteAddr()是否为空——某些异常断连会导致conn为nil，defer触发panic但被recover吞掉，现象就是goroutine消失无痕迹。
本地调试时客户端连不上localhost:8080/ws
不是端口被占，而是浏览器同源策略或Go服务绑定地址不对。GoLand默认运行的是localhost，但前端页面若从file://打开或走http://127.0.0.1，都可能触发跨域或协议不匹配。
实操建议：
- 服务启动时明确绑定
":8080"而非"localhost:8080"，后者在某些系统上只监听IPv6； - 前端WebSocket构造函数必须用
new WebSocket("ws://localhost:8080/ws")，不能漏掉ws://，也不能写成http://； - Chrome开发者工具Network标签页过滤
ws，点开连接看Headers里的Sec-WebSocket-Accept是否存在，没有说明服务端没完成握手； - 如果用Vue/React本地开发服务器（如
npm run serve），需配devServer.proxy把/ws代理到http://localhost:8080，否则浏览器实际请求的是http://localhost:8080/ws（非WebSocket协议）。
网络调试最麻烦的从来不是连不上，而是连上了却没数据、有数据却收不到、收到却解不开。GoLand能帮你停住goroutine、看变量值、查调用栈，但它不会自动告诉你websocket.Upgrader.CheckOrigin返回false导致握手被拒——这种逻辑判断得靠你自己加日志、比对RFC6455、再翻gorilla源码确认行为边界。
