websocket长连接存活由heartbeat_check_interval和heartbeat_idle_time联合控制，request_timeout仅作用于http握手阶段，不参与后续帧通信；服务端基于最后收发时间戳主动轮询检测空闲，需配对设置且大于检查间隔，生产环境须叠加应用层心跳以应对nat等假死场景。

WebSocket长连接不会因request_timeout失效，Swoole里真正的空闲超时由heartbeat_check_interval和heartbeat_idle_time联合控制。

为什么request_timeout对WebSocket无效

很多人误以为设置request_timeout就能控制WebSocket连接存活时间，其实它只作用于HTTP请求生命周期——而WebSocket握手完成后就脱离HTTP上下文了，后续所有帧通信都不走这个参数。强行设它，既不生效，还可能干扰HTTP子服务（比如你共用同一Server实例跑HTTP接口）。

• request_timeout仅在onRequest回调中起作用，WebSocket的onMessage、onOpen等回调完全绕过它
• 若你在onMessage里做耗时同步操作（如file_get_contents），真正卡住的是event loop，不是超时机制
• Swoole 5.0.3之前版本在协程调度上有bug，request_timeout相关定时器可能漏触发，建议升到5.1.0+

heartbeat_check_interval和heartbeat_idle_time怎么配

这才是决定WebSocket连接“活多久”的核心参数。它们不依赖客户端是否发ping，而是服务端主动轮询检测空闲状态：

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

• heartbeat_check_interval：服务端每隔多少秒扫描一次所有连接，默认值是60，建议设为30或更小（如25），避免检测滞后
• heartbeat_idle_time：连接最后一次收/发数据后，最多允许空闲几秒；必须严格大于heartbeat_check_interval，否则刚检查完就断连；常见设为60、90或120
• 真实断连时机 = 最后一次通信时间 + heartbeat_idle_time，但实际触发在下一个heartbeat_check_interval周期内
• 例如：heartbeat_check_interval => 30，heartbeat_idle_time => 90 → 连接空闲满90秒后，在接下来30秒内的某次检查中被关闭

客户端不发ping，服务端心跳还生效吗

生效，但只管“空闲”，不管“假死”。Swoole的心跳检测纯基于时间戳，不依赖WebSocket协议层的ping/pong帧：

• 只要连接有任意数据收发（哪怕只是业务消息），last_time就会刷新，重置空闲计时器
• 如果客户端网络中断但TCP连接未RST（如NAT超时、防火墙静默丢包），服务端仍会等到heartbeat_idle_time后才关连接
• 所以生产环境必须配合客户端主动心跳（如每25秒发{"type":"ping"}），服务端onMessage里识别并回{"type":"pong"}，才能快速感知真断连
• 别依赖浏览器自动ping：Chrome等浏览器的自动ping间隔不可控，且不保证送达，Swoole也收不到这些底层帧

容易被忽略的资源泄漏点

超时配置只是表象，真正让连接“该断不断”的，往往是代码里没清理的状态：

• 在onClose回调里忘记unset($connections[$fd])或删Redis记录，导致下次同IP重连时频控失效
• 用$server->connections迭代器做广播时，每次遍历都触发全量扫描，万级连接下CPU飙升，间接拖慢心跳检测频率
• PHP 8.2+环境下，Swoole 5.0.x版本存在timer与协程调度冲突，heartbeat_check_interval可能延迟数倍执行，务必验证php --ri swoole输出中websocket => enabled且版本≥5.1.0
• 启动前没查端口：lsof -i :9501或netstat -tuln | grep 9501，残留进程会吃掉心跳检测能力

超时不是调两个数字就完事——它卡在连接管理、资源清理、版本兼容三者的交界处，少一个环节，连接就悬在那里不动声色地吃内存。