Swoole 中使用原生 sleep() 会导致子进程无限挂起，必须改用协程安全的 co::sleep() 或启用对应的协程 Hook。本文详解原因、修复方法及最佳实践。
swoole 中使用原生 `sleep()` 会导致子进程无限挂起，必须改用协程安全的 `co::sleep()` 或启用对应的协程 hook。本文详解原因、修复方法及最佳实践。
在 Swoole 的多进程模型中（尤其是配合 PHPUnit 等测试框架运行时），看似简单的 sleep(1) 调用极易引发进程“假死”——程序输出 "Start main process!" 后便不再继续，也无错误退出。根本原因在于：sleep() 是同步阻塞系统调用，会阻塞当前线程/进程，而 Swoole 的 Process 子进程默认运行在非协程环境，但其底层调度仍受 Swoole 事件循环影响；若未显式启用 sleep Hook，该阻塞将无法被事件循环接管，导致父进程 wait() 或测试框架等待超时，表现为永久挂起。
✅ 正确做法是：在协程上下文中使用 co::sleep()（推荐），或全局启用 SWOOLE_HOOK_SLEEP Hook（需谨慎）。
✅ 推荐方案：使用 co::sleep()
co::sleep() 是 Swoole 提供的协程友好型异步睡眠，毫秒级精度，不阻塞事件循环：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
<?php
namespace Tests\Util;
use PHPUnit\Framework\TestCase;
use Swoole\Coroutine as Co;
class MultiprocessingTest extends TestCase
{
public function testProcess(): void
{
$t = new \Swoole\Process(function ($process) {
Co::sleep(1); // ✅ 替换 sleep(1)，协程安全，1 秒后继续
echo "Run task\n";
}, false);
$t->start();
echo "Start main process!\n";
// 注意：为确保子进程执行完毕，建议添加 $t->wait()（尤其在 CLI 测试中）
$t->wait(); // 防止主进程提前退出，丢失子进程输出
}
}⚠️ 备选方案：启用 Sleep Hook（仅限明确需要兼容原生函数场景）
若项目中大量使用 sleep() 且难以逐处替换，可在进程启动前启用 Hook（必须在 Swoole\Process 创建前调用）：
\Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_SLEEP); // 启用 sleep Hook // 然后创建 Process...
? 重要提醒：
- Hook 机制依赖 Swoole\Runtime::enableCoroutine()，且需在任何协程/进程操作前初始化；
- SWOOLE_HOOK_SLEEP 仅对 后续创建的协程 生效，对已存在的同步上下文无效；
- 在 PHPUnit 测试中，Hook 应置于 setUp() 或 @before 方法中，避免作用域失效；
- 强烈建议优先采用 co::sleep() —— 语义清晰、可控性强、无需全局副作用。
? 补充注意事项
- Swoole\Process 默认以 独立进程 方式运行，但其内部 I/O（如 echo）可能受父进程输出缓冲影响，建议在测试中显式调用 $t->wait() 确保子进程结束；
- 若需更复杂的异步任务调度，可结合 Swoole\Coroutine\run() 或 Swoole\Server 的 Worker 进程模型；
- 所有协程函数（包括 co::sleep()）只能在协程环境中调用；在普通 PHP 环境（如 CLI 直接执行）中调用会抛出 Swoole\Error: coroutine is not running 异常 —— 因此 Process 回调中直接使用是安全的（Swoole 自动为其创建协程上下文）。
遵循以上规范，即可彻底解决 Swoole 进程因 sleep() 导致的挂起问题，保障多进程逻辑稳定、可预测地执行。
