send返回false表示数据未进入应用层发送缓冲区,仅因客户端断开或缓冲区已满(默认1MB);需通过isClosed()判断原因,并依赖onBufferFull/onBufferDrain事件处理流控。

send 返回 false 的真实含义是什么
send 返回 false 不代表“数据没发出去”,而是明确告诉你:这次调用失败了,数据压根没进应用层发送缓冲区。常见原因只有两个:客户端连接已断开($connection->isClosed() 为 true),或者当前连接的应用层缓冲区已满(默认 1MB,不可配置)。它和网络丢包、超时、TCP 重传完全无关——那些阶段 send 早已返回 true 或 null。
怎么判断是连接断开还是缓冲区满
先查连接状态:
- 立即调用
$connection->isClosed(),如果返回true,说明对端已关闭连接(FIN/RST 收到或本地主动 close),此时再 send 必然false - 如果
isClosed() === false,但send连续返回false,大概率是应用层缓冲区积压严重——比如你疯狂send而不等onBufferFull或未启用onMessage处理响应逻辑,导致数据堵在 Worker 内部缓冲区
注意:send 不会因“对方接收太慢”而阻塞或失败;它只管把数据塞进自己的缓冲区,满了就直接 false,不会等。
缓冲区满时的正确应对方式
Workerman 不提供“等待缓冲区腾出空间”的同步 API,必须靠事件驱动来解耦:
- 监听
$connection->onBufferFull,触发时暂停发送,改用$connection->pauseRecv()防止新数据进来加剧堆积 - 在
$connection->onBufferDrain中恢复发送和接收:$connection->resumeRecv() - 避免在
onMessage里直接循环send大量数据;拆成小块,每次send后检查返回值,false就退回去等onBufferDrain
示例片段:
$connection->onBufferFull = function ($connection) {
echo "buffer full, pausing\n";
$connection->pauseRecv();
};
$connection->onBufferDrain = function ($connection) {
echo "buffer drained, resuming\n";
$connection->resumeRecv();
// 此处可触发下一批 send
};
为什么不能忽略 false 直接重试
连续对一个已断开或缓冲区满的连接调用 send,不仅无效,还会掩盖真正问题:
- 若连接已断开,重试只是浪费 CPU,且可能干扰
onClose的清理逻辑 - 若缓冲区满却强行重试,会跳过
onBufferFull,导致内存持续增长甚至 OOM - 某些场景下(如协议分包),漏掉一次
false可能造成后续所有数据解析错位
最稳妥的做法是:遇到 false,立刻停止当前连接的发送行为,记录日志(含 $connection->id 和时间戳),然后依赖 onClose 或 onBufferDrain 来恢复流程。别试图在业务层做“可靠重传”——TCP 层已经负责了,应用层只需尊重它的流控信号。











