应使用Swoole\Coroutine::list()获取存活协程ID列表，结合Swoole\Coroutine::stats()中coroutine_num持续增长判断泄漏；再通过Co::getuid()在go内打点记录协程ID，配合debug_backtrace()抓取堆栈定位卡点。
协程卡死时怎么快速定位是哪个 go 启动的协程没结束？
协程卡死往往不是“全挂”，而是某个协程阻塞在 I/O 或死循环里，导致整个协程调度器被拖慢。Swoole 提供了 Swoole\Coroutine::list() 和 Swoole\Coroutine::stats() 两个关键函数来查状态。
注意：Swoole\Coroutine::list() 返回的是当前存活协程 ID 列表（int[]），但不包含上下文信息；真正有用的是 Swoole\Coroutine::stats()，它返回一个数组，含 coroutine_num、coroutine_peak_num、coroutine_last_id 等统计值——其中 coroutine_num 是当前活跃数，若持续增长不回落，基本可断定有协程泄漏。
- 在关键逻辑前后打点：比如
go(function () { echo "start: " . Co::getuid() . "\n"; ... }); - 用
Co::getuid()获取当前协程 ID，并配合日志记录入口/出口，避免靠猜 - 不要依赖
getmypid()或进程 ID 判断——协程是轻量级的，同个进程内大量协程共享 PID
为什么 var_dump 或 print_r 在协程里会卡住？
因为 var_dump 默认输出到 stdout，而 Swoole 协程环境下 stdout 可能被重定向或未启用协程化 I/O，导致底层调用阻塞在 write() 系统调用上，进而让当前协程无法让出控制权。
更隐蔽的问题是：某些 IDE 的 Xdebug 或 CLI 输出缓冲机制与协程调度器冲突，尤其在 co::sleep(0) 或 Co::yield() 前后突然卡住。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 改用
Co::writeStdout()（Swoole v4.8.13+）安全输出调试信息 - 或直接写文件：
file_put_contents('/tmp/debug.log', print_r($data, true) . "\n", FILE_APPEND | LOCK_EX)，注意加LOCK_EX避免多协程乱序 - 禁用 Xdebug 的远程调试（
xdebug.mode=off），它会强制同步阻塞协程调度
如何查看某个协程正在执行哪一行 PHP 代码？
Swoole 没有内置协程级 stack trace，但可以通过 debug_backtrace() + Co::getuid() 组合，在协程内部主动抓快照。
关键限制：必须在目标协程内触发，不能从外部“偷看”。所以常见做法是在可疑位置插入调试钩子，而不是指望全局监控。
- 在可能卡住的地方加：
if (Co::getuid() == $target_cid) { file_put_contents('/tmp/trace.log', print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS), true)); } -
DEBUG_BACKTRACE_IGNORE_ARGS能避免序列化大对象引发内存暴涨 - 不要在高频路径（如 onReceive 回调）无条件调用
debug_backtrace()，性能损耗明显（每次约 0.1–0.3ms）
Co::suspend() 和 Co::resume() 配合调试时容易踩什么坑？
这两个函数用于手动挂起/唤醒协程，常被用来模拟阻塞点做状态观察。但它们不是“暂停执行”，而是彻底交出调度权——一旦 suspend()，该协程就进入等待队列，直到被显式 resume() 或超时（如果设了 timeout）。
最典型误用：忘记 resume()，或在错误协程里调用 resume()（resume() 必须由其他协程调用，不能自 resume）。
- 务必检查
Co::resume($cid)的返回值：true表示成功唤醒，false表示协程已结束或不存在 - 慎用
Co::suspend(1000)这类带 timeout 的写法——timeout 触发后协程会自动 resume，但你可能没监听到，导致后续逻辑错乱 - 调试期间建议搭配
Swoole\Timer::after()自动 resume，避免手抖漏调
Co::getuid() 标记 + Co::stats() 定期采样 + 主动 debug_backtrace() 快照的组合。最容易被忽略的是：协程 ID 在 go 启动瞬间才分配，Co::getuid() 在 go 外调用永远返回 0。 
