协程卡死时swoole_get_local_cid()返回-1，说明调度器失活、协程上下文丢失；需立即检查同步I/O（如file_get_contents、curl_exec）、禁用非协程安全调用，用strace和Coroutine::listCoroutines()定位WAITING状态协程的阻塞点。
协程卡死时 swoole_get_local_cid() 返回 -1 怎么办
这说明当前线程已脱离协程上下文，不是没启动协程，而是调度器彻底失活、无法唤醒任何协程。进程表现为 CPU 占用极低、无日志输出、kill -USR2 无响应——它安静地“睡着”了。
根本原因几乎总是：在协程中执行了非协程安全的同步 I/O，比如 file_get_contents()、curl_exec()、sleep()，或老版本 Redis 扩展的 connect() 调用（内部用了 stream_socket_client）。
- 立刻检查所有
vendor/下 SDK 的__construct和connect方法，搜stream_socket_client或fsockopen - 禁用任何
ini_set('swoole.enable_coroutine', '0')类临时关闭逻辑，Hyperf 依赖全程协程环境 - 用
strace -p <pid> -e trace=epoll_wait,read,write观察是否长期卡在epoll_wait且无后续系统调用
怎么用 Coroutine::listCoroutines() 找出 WAITING 协程
别只看协程总数，重点是状态为 SWOOLE_CORO_WAITING 且堆栈停留在 I/O 调用点的协程。这些才是真正在“等”的卡点。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
Coroutine::listCoroutines()返回的是整数 CID 数组，不是对象，别写成$coro->getBackTrace() -
Coroutine::getBackTrace($cid, 0, 20)第二个参数必须是0，否则可能跳过最深一层（即阻塞调用本身） - 重点关注堆栈末尾是否出现
stream_select、socket_read、curl_exec、file_get_contents - 更稳妥的方式是在异常中间件或定时任务里插入诊断逻辑，而非依赖
kill -USR1写日志（/tmp/swoole-coroutine-*.log权限常为 600）
[fatal error]: all coroutines (count: 1) are asleep - deadlock! 是什么
这不是数据库死锁，也不是 PHP 层死循环，而是 Swoole 调度器发现只剩一个协程，且它正执行 Co::sleep()、co::read() 等让出控制权的操作，但再无其他协程或 I/O 事件可轮转——于是整个进程挂起。
- 典型场景：定时器回调里启协程，但协程内只有
Co::sleep(1)，没有 HTTP 请求、DNS 查询、Redis 调用等 I/O 唤醒点 - 父进程禁用协程（
swoole_async_set(['enable_coroutine' => false])），子进程却启协程并只调sleep() - 验证方式：用
strace -p <pid> -e trace=futex看是否卡在futex；再用php ./vendor/bin/swoole-tracker status查coroutine_num是否长期为 0 或 1 - 别把
$signal === 11（SIGSEGV）当成死锁，那是 C 层崩溃，得开 core dump 用 gdb 分析
Hyperf 定时任务卡死和普通 PHP 死循环怎么区分
两者表现相似但根因完全不同，错判会导致排查方向完全跑偏。
- CPU 持续 100% + 日志停更 +
swoole_get_local_cid()返回 -1 → 协程卡死（同步 I/O 阻塞） - 内存缓慢但持续上涨 + worker PID 序号飙升（如到 78 万）+ 卡在整点前后 → 定时任务闭包中静态变量累积、大对象未释放
- 进程直接退出 + 日志出现
Fatal error: Maximum function nesting level→ 递归过深或构造器循环依赖 - 检查定时任务闭包：禁用
sleep()、file_get_contents()；重逻辑投递到TaskWorker；加['timeout' => 50000]参数兜底
协程卡死最难搞的点，往往不在报错本身，而在于它不报错——进程静默、日志中断、CPU 归零。这时候翻代码比看监控管用：全局搜 go( 和 sleep( 组合，再顺着调用链查是否混入了同步 I/O。
