长连接断开主因是中间件超时主动断连而非网络故障;需在Workerman中自实现心跳机制,同步响应ping/pong,并配合Nginx调大proxy_read_timeout等参数。

长连接断开不是因为“网络坏了”,而是中间件主动砍的
长连接本身在 TCP 层面是稳定的,只要两端进程没挂、物理链路没断,连接就能一直维持。但现实里你根本等不到“自然存活”,因为从客户端到服务端之间堆着一堆中间件:Nginx 默认 proxy_read_timeout 60s、运营商 NAT 网关空闲超时常为 30–120 秒、AWS ALB 固定 60 秒不可调、Android 系统后台休眠后 Socket 可能被静默回收。它们不关心你逻辑上“还没说完”,只认“这管道多久没流水了”。一旦超时,直接 FIN 断连,且不通知你。
Workerman 中 onMessage 不等于心跳,得自己加探测逻辑
Workerman 的 onMessage 只响应真实业务消息,它不会自动触发任何保活行为。如果你只靠用户发聊天消息来“刷活”,那两次消息间隔一超过中间件超时阈值,连接就凉了。必须显式插入心跳探测流程:
- 客户端需定时(比如 25 秒)发送一个轻量协议包,例如 JSON:
{"type":"ping","ts":1716498543} - 服务端在
onMessage里识别该 type,不做业务处理,仅立即回{"type":"pong"} - 同时维护每个
$connection的最后心跳时间戳,用Timer::add()启动后台检查任务,比如每 30 秒扫一次,对超时(如 >60 秒未 ping)的连接调用$connection->close()
注意:别把心跳响应写成异步回调或丢进协程队列——它必须同步、低延迟、无阻塞,否则 pong 拖延会导致客户端误判超时。
Worker::$maxConnection 和心跳并发数不是一回事
Workerman 的 $maxConnection 控制的是最大允许建立的连接数,但它不感知连接是否“真活着”。如果你没做心跳清理,大量假连接会占满这个配额,新用户连不进来,而监控看连接数又没爆,排查起来极隐蔽。
- 心跳超时清理必须独立实现,不能依赖 Workerman 自带连接管理
- 检查频率建议设为心跳间隔的 1.5–2 倍(如心跳 25s,检查周期设 40s),避免高频扫描损耗 CPU
- 清理动作要加锁或用
if ($connection->isConnected())再 close,防止 race condition 导致对已断连接重复 close 报 warning
Nginx 配置不改,Workerman 心跳再勤也白搭
Workerman 侧的心跳只是应用层努力,若 Nginx 还卡着默认 60 秒,它会在第 61 秒直接断掉 TCP 连接,客户端收不到任何 pong,只会看到 WebSocket is already in CLOSING or CLOSED state 或直接 onerror。必须同步调整 Nginx:
-
proxy_read_timeout 86400;—— 允许后端 24 小时不发数据也不断 -
proxy_send_timeout 86400;—— 同理,防止大包分片慢导致误杀 -
proxy_set_header Connection 'upgrade';和Upgrade $http_upgrade;必须存在,否则 Nginx 当普通 HTTP 处理,压根不通 WebSocket
配置生效后记得 nginx -t && nginx -s reload,光改配置不重载等于没改。
最容易被忽略的一点:心跳包内容不能全一样。有些防火墙或代理会缓存“重复小包”并直接丢弃,建议在 ping 中带上毫秒级时间戳或递增序号,确保每次都是新 payload。

















