Swoole客户端connect()成功后连接快速断开是因为服务端heartbeat_idle_time超时主动断连,客户端需定期发送符合协议的心跳包(如带长度头的二进制格式),并用tick定时器维持,协程客户端不支持set(['heartbeat'=>x])自动心跳。

为什么 connect() 成功后连接还是很快断开
因为 Swoole 客户端默认不开启心跳,服务端(尤其是 swoole_server)在空闲超时(heartbeat_idle_time)后会主动踢掉连接。这不是客户端崩了,是服务端“礼貌清退”。
- 检查服务端配置:
heartbeat_idle_time默认 60 秒,heartbeat_check_interval默认 30 秒——意味着最多 60 秒无任何数据收发,连接就被关 - 客户端必须主动发心跳包,且频率要小于服务端的
heartbeat_idle_time(建议设为 45 秒以内) - 别依赖
onConnect后就万事大吉,Swoole 的 TCP 连接是“活连接”,得靠持续通信维持
send() 发心跳包但服务端收不到?检查这三处
手动调用 send() 发心跳最直接,但容易因协议、时机或缓冲问题失效。
- 心跳内容必须符合服务端预期:如果服务端用
open_length_check或自定义包头,发纯字符串"ping"可能被丢弃;建议统一用\x00\x00\x00\x01\x01这类带长度头的格式(和服务端解析逻辑对齐) - 不能只在
onConnect里发一次:要用tick或after定期触发,例如$client->tick(45000, function() use ($client) { $client->send("ping"); }); - 注意
send()返回值:返回false不代表失败,可能是缓冲区满或连接已断;务必加if (!$client->isConnected())判断再重连
用 set() 开启自动心跳反而更不稳定?
Swoole 4.4+ 支持客户端通过 set(['heartbeat' => 45]) 启用内置心跳,但它只对 swoole_client(同步)有效,swoole_http_client 和协程 Co\Http\Client 不支持——这点文档没说清,很多人踩坑。
-
swoole_client(非协程)可用:$client->set(['heartbeat' => 45]);,它会在空闲 45 秒后自动发\x00字节 - 协程客户端(
Co\Socket/Co\Http\Client)完全不识别该选项,设了也白设,必须手写tick+send() - 自动心跳不触发
onReceive,也不受open_eof_split影响,服务端需单独适配这种单字节心跳
心跳包被当成业务数据误处理怎么办
核心是区分心跳和业务帧。Swoole 没内置心跳协议字段,全靠你自己设计边界。
- 最稳妥:心跳走独立连接(比如专门起一个
swoole_client只发心跳),和业务连接隔离 - 同连接混用:约定心跳格式,比如固定前 2 字节为
0xFF 0xFE,服务端收到先判断头,是心跳就return,不进业务逻辑 - 避免用纯文本
"ping"/"pong":某些代理或防火墙会拦截/改写这类字符串,二进制标识更可靠
真正麻烦的不是发心跳,而是服务端怎么安全响应、客户端怎么确认响应有效——比如服务端延迟回包、网络抖动导致 recv() 超时,这些都要在心跳逻辑里补重试和状态标记,不然你以为连着,其实早断了。









