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"字符串，而没带换行或特殊分隔符，某些云网关会当成无效流量忽略保活效果。
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
- 推荐心跳消息固定为
{"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支持”只是指协议透传，不等于帮你保活。所有超时参数、心跳逻辑、重连退避策略，都得你自己在应用层写死，中间件不会替你思考。
