WebSocket如何保持长连接不断开 阿里腾讯云服务器WS保活教程

WebSocket在阿里云/腾讯云上频繁断开，需同时调大Nginx proxy_read_timeout/proxy_send_timeout、使用JSON格式心跳、配置SLB/CLB健康检查、前端规避后台冻结、服务端实现pong超时检测与主动关闭。

WebSocket在阿里云或腾讯云服务器上频繁断开，不是代码写得不对，而是中间件和云平台默认配置天然“反长连接”——必须手动调参+双向心跳协同，缺一不可。

nginx proxy_read_timeout 必须大于心跳间隔

阿里云SLB、腾讯云CLB背后普遍用Nginx做七层代理，默认proxy_read_timeout 60s。只要后端60秒没往客户端发数据，Nginx就直接FIN掉连接，日志里是499或upstream timed out。

• 心跳间隔设为30秒？那proxy_read_timeout至少得设成300s（5分钟），留出2次心跳余量
• 必须同步调大proxy_send_timeout，否则服务端发pong慢一点也会被掐
• 云控制台改配置不生效时，要确认是否走的是SLB/CLB直连，还是你自己的ECS上装的Nginx——后者才认你写的conf

阿里云SLB和腾讯云CLB的空闲超时不能只靠心跳

SLB默认TCP空闲超时是900s（15分钟），CLB是600s（10分钟）。但注意：它们只检测TCP层有没有数据包，不解析WebSocket帧。如果你的心跳只是"PING"字符串，而没带换行或特殊分隔符，某些云网关会当成无效流量忽略保活效果。

腾讯云文字识别（通用高精度版）

腾讯云通用文字识别（高精度版）技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别，返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。

下载

• 推荐心跳消息固定为{"type":"ping"}这种JSON格式，比纯字符串更易被中间件识别
• SLB需开启“健康检查”，并把健康检查路径指向一个HTTP接口（如/health），否则它可能误判后端宕机而主动摘除节点
• CLB建议关闭“连接空闲超时”自动清理（如果控制台支持），或确保心跳间隔 ≤ 300s

移动端后台冻结导致心跳定时器失效

iOS Safari和Android Chrome在标签页切到后台后，setInterval会被系统降频甚至暂停，30s心跳可能变成5分钟才触发一次，结果还没发出去连接就被SLB回收了。

• 不要依赖setInterval发心跳，改用requestIdleCallback + setTimeout兜底组合
• 监听visibilitychange事件，页面不可见时立即发一次心跳，再重置定时器
• 真机调试时用Charles抓包看PING是否真的发出了，别只信console.log

服务端主动close前必须等pong响应

很多FastAPI/Node.js示例代码收到PING就立刻回PONG，但没做超时管理。一旦客户端网络卡顿，PONG发不出去，服务端继续等，连接堆积在CLOSE_WAIT状态，最终触发文件描述符耗尽。

• 每个WebSocket连接需绑定独立的pong_received标志位，收到PING时清零，收到PONG时置为true
• 启动一个setTimeout，比如30秒后检查该标志位，false就ws.close(4001, "pong timeout")
• 前端收到onclose且event.code === 4001，说明是服务端主动踢出，不是网络抖动，应延迟5秒再重连

最常被忽略的一点：云厂商的“WebSocket支持”只是指协议透传，不等于帮你保活。所有超时参数、心跳逻辑、重连退避策略，都得你自己在应用层写死，中间件不会替你思考。