swoole 中没有 waitevent 这一 api，它是面试中常见的概念混淆；实际相关的是 event::wait()（事件循环入口）和 coroutine::waitgroup（协程等待计数器），二者语义、用途及实现均无关联。
WaitEvent 不是 Swoole 官方 API，也不是任何稳定版本中定义的类、函数或常量。你在面试中听到这个词，大概率是面试官口误、混淆概念，或者考察你对底层机制的辨析能力。
为什么没有 WaitEvent？它和 WaitGroup 完全不是一回事
常见错误归因：把 Swoole\Coroutine\WaitGroup 误记为 WaitEvent，或把 Event::wait() 的“wait”和“event”两个词强行拼接。但 Swoole 没有提供名为 WaitEvent 的组件。
-
Event::wait()是事件循环入口，作用是阻塞等待所有异步任务完成（如Swoole\Async\Redis回调）； -
Swoole\Coroutine\WaitGroup是协程安全的计数器，用于等待一组协程结束； - 二者语义、使用场景、底层实现均无交集——混用会导致逻辑断裂或死锁。
Event::wait() 必须手动加，否则脚本秒退
在 CLI 脚本中发起异步操作（比如 Swoole\Async\MySQL 或 Swoole\Async\HttpClient），若不显式调用 Swoole\Event::wait()，PHP 进程会在主流程执行完后立即退出，回调根本没机会触发。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 错误写法：
go(function () { Co::sleep(1); echo "done\n"; });→ 输出为空，脚本直接结束； - 正确写法：
go(function () { Co::sleep(1); echo "done\n"; }); Swoole\Event::wait();； - Swoole 5+ 已移除自动补
Event::wait()的机制，必须手写，且只能调用一次； - 不能和
Coroutine\Scheduler混用：后者已内置完整调度，再调Event::wait()会卡住主线程。
Swoole\Coroutine\WaitGroup 必须在协程内创建并配对使用
这是真正用于“等待多个协程完成”的工具，但它的生命周期严格绑定于当前协程上下文。
- 必须在
go()或Co::create()启动的协程里 new：$wg = new Swoole\Coroutine\WaitGroup();； -
Add()和Done()必须成对出现在同一协程作用域，异常路径下Done()易被跳过，建议包在finally块里； - 绝不能存到
global、静态属性或$_SERVER中——协程销毁后对象可能被回收，后续访问触发Segmentation fault； - 它不依赖系统锁，纯靠协程调度器唤醒，所以能安全用于高并发协程环境。
容易被忽略的兼容性陷阱
最隐蔽的问题往往出在版本与启用时机上：
-
Swoole\Coroutine\WaitGroup仅在 Swoole 4.8+ 可用，低版本需自行用Channel+ 计数器模拟； -
Event::wait()在协程程序中基本不该出现——如果你写了，说明你可能没理解Coroutine\Scheduler::start()或Co::run()已接管整个生命周期； - 所有 hook 必须在
go()之前启用：Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_ALL)，否则file_get_contents()等仍会阻塞 Worker； - 协程内禁止用
sleep()，必须用Co::sleep()；全局变量不会自动重置，状态污染风险极高。
