Swoole中WaitGroup与Go WaitGroup的区别-Swoole-PHP中文网

swoole coroutine\waitgroup基于channel实现协程安全计数，仅限单线程协程环境；go sync.waitgroup基于mutex+cond，支持多线程并发。

swoole中waitgroup与go waitgroup的区别

WaitGroup 的底层实现机制不同

Swoole 的 Coroutine\WaitGroup 底层是用 Channel->pop() 模拟阻塞等待的，本质是个协程安全的计数器 + 协程挂起/唤醒逻辑；Go 的 sync.WaitGroup 是基于互斥锁（mutex）和条件变量（cond）实现的，运行在多线程调度器上。

这意味着：Swoole 版本只能在单线程协程环境里工作，不能跨线程复用；Go 版本天然支持多线程并发调用，Add/Done 可以从任意 goroutine 安全调用。

常见错误现象：Swoole\Coroutine\WaitGroup::wait(): cannot use in non-coroutine context —— 忘记在协程内调用 wait()，或在 WorkerStart 这类非协程回调中直接 new 并 wait。

WaitGroup 不可重用的含义不一样

两者都要求计数器归零后不能再调用 wait()，但“不可重用”的实际约束点不同：

Swoole：wait() 返回后，该 WaitGroup 实例彻底失效，再次调用 add() 会抛出 LogicException
Go：WaitGroup 归零后允许再次 Add()，只要没被 go 调度器回收（即对象仍存活），就能复用

所以 Swoole 中每次需要等一组新协程时，必须新建一个 new WaitGroup()；而 Go 项目里常把 sync.WaitGroup 声明为结构体字段，反复使用。

异常场景下 done() 的保障方式不同

Swoole 的 done() 必须手动确保执行，否则计数不归零 → wait() 永久阻塞。官方推荐用 defer 或 try-finally 包裹：

AI舌诊面诊问诊医疗系统+诊疗商城系统源码

下载

go(function () use ($wg) {
    try {
        // IO 操作
        Co::sleep(1);
    } finally {
        $wg->done();
    }
});

Go 的 Done() 虽然也建议配 defer，但即使漏写，最多是 panic（如果计数负溢出），不会导致整个 goroutine 永久卡死——因为 Go runtime 有更严格的计数校验和 panic 机制。

容易踩的坑：Swoole 里只在正常流程写 $wg->done()，没包 finally，一旦协程因超时、异常或 exit() 提前退出，主协程就再也等不到它了。

WaitGroup 和协程生命周期绑定强度不同

Swoole 的 WaitGroup 与协程强绑定：它只能在协程上下文中创建和使用，且所有 add()/done() 都必须发生在协程内；Go 的 WaitGroup 是纯数据结构，可以跨 goroutine、甚至跨函数栈传递（比如作为参数传入闭包）。

典型差异表现：

你不能在 Swoole 的 onWorkerStart 回调里 new 一个 WaitGroup 然后丢给子协程用——必须在 go() 内部或 onRequest 这类已进入协程环境的地方初始化
Go 里你可以把 *sync.WaitGroup 当作依赖注入进任何函数，完全解耦

这点决定了 Swoole 的 WaitGroup 更像是“一次性的同步原语”，而 Go 的更接近通用并发工具——它的设计假设是开发者对内存模型和调度有更强掌控力。