WebSocket连接频繁断开怎么排查

先核对连接链路与基础参数

可以优先检查协议是否正确、连接地址是否稳定、端口是否被代理或防火墙拦截，以及客户端和服务端的超时时间设置是否匹配。还要留意反向代理、负载均衡和网关是否支持 WebSocket 升级请求，因为这些组件若配置不当，容易让连接在握手或空闲阶段被断开。

重点确认心跳是否稳定送达

这种现象很常见，通常和心跳间隔、超时时间、网络抖动有关。可以检查客户端是否按约定周期发送心跳，服务端是否能正确响应，以及中间链路是否会因为空闲时间过长而主动回收连接。若心跳频率太低，连接可能被代理判定为空闲；若太高，也可能带来额外负担，需要结合业务场景调整。

从用户网络与终端环境入手分析

这种情况下，除了服务端日志，还要重点看用户侧网络环境，例如弱网、频繁切换 Wi-Fi 和移动网络、代理软件、企业防火墙或运营商链路波动。也要关注客户端设备是否进入休眠、省电模式或被浏览器回收后台连接。通过对比正常用户和异常用户的网络类型、设备型号、系统版本与断线时间点，通常能更快缩小范围。

补充握手、关闭码与链路层日志

有些断开并不会触发明显异常，建议补充记录握手过程、关闭码、断线时间、客户端标识和重连次数。还可以查看网关、Nginx、负载均衡、容器平台的日志，因为连接可能是在这些中间层被关闭。若只看应用层日志，容易遗漏连接在升级阶段或空闲回收阶段被切断的线索。