WebSocket连接失败的常见原因及排查技巧

1. WebSocket连接失败的五大常见原因

第一次用WebSocket就被坑惨了！记得去年做实时聊天功能时，本地测试一切正常，上线后用户反馈消息老是断连。折腾了整整两天才发现是Nginx没配WebSocket协议支持。这种问题其实很典型，我把常见的坑总结成五类：

协议握手失败是最容易踩的坑。WebSocket建立连接时要先发HTTP Upgrade请求，如果服务器没正确响应101状态码就会失败。有次我用Postman测试时发现返回的是200 OK，仔细检查才发现忘记在Spring Boot配置里加@EnableWebSocket注解。

跨域限制这个坑特别隐蔽。浏览器会严格检查WebSocket的Origin头，而小程序环境相对宽松。有次遇到本地开发能用，上线后浏览器访问就报跨域错误，最后发现是Nginx配置漏了这几行：

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

证书问题在使用wss协议时经常出现。有次生产环境突然报SSL握手错误，查了半天发现是证书链不完整。建议用openssl命令验证：

openssl s_client -connect yourdomain.com:443 -showcerts

防火墙拦截经常被忽略。某次客户内网部署时，发现WS连接始终超时，最后发现是他们防火墙策略只放行了80/443端口。记住WebSocket可能使用任意端口，需要特殊配置。

心跳超时属于运行期问题。有次用户反映连接经常无故断开，后来发现是移动网络不稳定导致心跳包丢失。解决方案是双重超时设置：