WebSocket握手返回400或断连，本质是Upgrade和Connection头部缺失、非法或被代理/中间件拦截，导致服务端无法完成HTTP升级；需检查Nginx配置（proxy_http_version 1.1、proxy_set_header Upgrade $http_upgrade、proxy_set_header Connection "upgrade"）、请求头合规性（Sec-WebSocket-Key格式、大小写敏感）、中间件顺序及GoLand调试干扰。
WebSocket握手时返回400或直接断连，先确认GoLand是否劫持了请求
GoLand的调试器默认会注入代理逻辑，尤其在启用“Run with coverage”或某些插件后，可能干扰原始HTTP头。WebSocket握手本质是HTTP升级请求，Upgrade: websocket 和 Connection: Upgrade 这两个头被任意修改或丢失都会导致服务端拒绝（常见于gin、echo等框架的中间件校验）。
- 临时关闭GoLand的Coverage工具：Run → Edit Configurations → 取消勾选
Enable coverage - 检查是否启用了HTTP代理相关插件（如“HTTP Client”或“REST Client”插件），尝试禁用后重启IDE
- 在调试配置中添加环境变量：
GOINSECURE="*"（若服务端用自签名证书，否则TLS握手失败也会表现为400）
服务端日志看不到Upgrade请求？用GoLand的Network工具抓原始流量
GoLand 2023.3+ 内置了Network面板（View → Tool Windows → Network），但默认不捕获调试进程的出站请求。它只监听本机HTTP(S)端口，而WebSocket握手是客户端发起的，需手动触发并确保目标地址走本地回环。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在代码中把WebSocket连接地址写死为
"ws://localhost:8080/ws"，避免DNS解析绕过Network监听 - 启动服务后，在Network面板右上角点击
Start capturing，再运行WebSocket客户端代码 - 筛选类型为
ws或状态码为101的条目，点开看Request Headers是否含Sec-WebSocket-Key和Upgrade；Response Headers是否返回101 Switching Protocols
断点打在handler里却从不命中？检查路由注册和中间件顺序
WebSocket握手请求仍走HTTP路由，但很多Go Web框架（如gin）要求WebSocket handler必须注册在未被其他中间件拦截的路径上。如果在全局注册了JWT验证中间件，而握手请求没带token，就会在中间件层直接返回401/400，根本到不了你的handler。
- 在handler函数第一行加
log.Println("WS handshake start")，而不是只依赖断点——GoLand断点可能因内联优化或goroutine调度未触发 - 对比正常HTTP GET请求能否到达同一路径：如果能，说明问题出在WebSocket特有头校验；如果也不能，说明路由或中间件配置错误
- gin用户注意：
engine.GET("/ws", wsHandler)必须在Use()全局中间件之后注册，否则中间件会拦截
用curl模拟握手失败，快速验证服务端行为
别依赖前端页面或JS库重试逻辑，用最简curl复现可排除客户端干扰。GoLand调试时服务端通常跑在本地，curl能绕过所有浏览器策略和IDE代理。
- 执行以下命令（替换
your-key为任意base64字符串，如$(openssl rand -base64 16)）：
curl -i \ -H "Connection: Upgrade" \ -H "Upgrade: websocket" \ -H "Sec-WebSocket-Version: 13" \ -H "Sec-WebSocket-Key: your-key" \ http://localhost:8080/ws
101而返回400，大概率是Sec-WebSocket-Key格式非法或服务端未开启WebSocket支持；返回404说明路由没注册；返回500则需查服务端panic日志
