swoole_get_local_cid()返回-1说明协程调度器已离线，根本原因是同步i/o阻塞（如file_get_contents、curl_exec）或误用sleep等非协程安全操作，需通过strace、coroutine::listcoroutines()定位waiting状态协程的阻塞点。
协程卡死时 swoole_get_local_cid() 返回 -1 怎么办
这是协程调度器已离线的明确信号，不是“协程没启动”，而是当前线程彻底失去上下文，无法再调度任何协程。此时进程可能仍在运行，但所有协程都处于永久 WAITING 或 DEAD 状态。
常见诱因包括：file_get_contents、curl_exec、sleep、未适配协程的 Redis/MySQL SDK 的 connect() 调用。这些函数会直接阻塞线程，让调度器无从介入。
- 先确认是否误在协程中用了非协程安全函数：检查所有
vendor/下 SDK 的__construct和connect方法，重点搜stream_socket_client、fsockopen - 禁用任何手动关闭协程的配置，如
ini_set('swoole.enable_coroutine', '0')—— Hyperf 依赖全程协程环境，临时关闭只会让问题更隐蔽 - 用
strace -p <pid> -e trace=epoll_wait,read,write</pid>观察是否长期停在epoll_wait且无后续系统调用；若持续卡住，基本可判定是同步 I/O 阻塞
怎么用 Coroutine::listCoroutines() 找出 WAITING 协程
Coroutine::listCoroutines() 返回的是整数 CID 数组，不是对象，别试图对它调 ->getBackTrace()。它的作用是快速筛出“活着但不动”的协程，而非统计总数。
关键不是数量，是状态。只有 SWOOLE_CORO_WAITING 状态才值得深挖——说明它挂起在某个 I/O 点，正等着被唤醒，但一直没等到。
- 在异常中间件或定时任务里插入诊断逻辑，遍历每个 CID，用
Coroutine::getStatus($cid)判断状态 - 对
WAITING协程立即调Coroutine::getBackTrace($cid, 0, 20)，第二个参数必须是0，否则会跳过最深一层（也就是阻塞点本身） - 重点看堆栈最后一行：是不是
stream_select、socket_read、curl_exec、mysqli_query？这些就是真凶 - 快照日志默认权限为
600，若 worker 以非 root 用户运行，确保/tmp可写，且 SELinux 没拦截日志路径
async-queue:info 显示 processing 长期为 0 是什么信号
这不是队列积压，是消费侧协程池已瘫痪的典型表现。当 php bin/hyperf.php async-queue:info 输出中 pending 持续上涨、failed 不断新增、而 processing 长期卡在 0 或极低值（比如始终是 1～2），说明消费者根本没动起来。
背后大概率是：Redis 连接池耗尽、MySQL 慢查询卡住整个 Worker、或 Job 内部用了 sleep / file_get_contents 导致单个协程长期霸占线程。
- 别只看 Redis CLI 的
LLEN queue:default—— 它包含已出队未 ack 的任务，不可信 - 检查
config/autoload/async_queue.php是否为队列配置了独立连接池（'pool' => 'queue'），避免和 HTTP 请求抢 Redis 连接 - 临时把 Job 的
handle()全注释掉，只留Coroutine::sleep(1)，再压测；如果内存不涨、processing恢复正常，说明泄漏就在你写的业务逻辑里 - 执行
co::stats()，观察coroutine_num是否暴涨但request_count几乎不动 —— 这是慢 SQL + 错配连接池的铁证
协程 CPU 占用 100% 但无日志输出怎么定位
这是纯 CPU 密集型任务导致的协程饥饿：没有 IO 阻塞点，调度器无法触发切换，协程独占线程跑满一个核。现象是接口超时、新请求进不来、日志静默、swoole_get_local_cid() 可能仍返回有效 ID（区别于 -1）。
典型场景包括：大数组遍历、JSON 解析、Base64 编码、循环加密、未拆分的批量数据格式化。
- 用
top -H -p $(pgrep -f 'YourProcessName')查线程级 CPU，找出长期 >90% 的线程 PID - 用
gdb -p <pid> -ex 'thread apply all bt' -ex quit</pid>抓堆栈，看是否卡在 PHP 循环或 hash 计算里 - 在密集计算循环中每处理 N 条后加
Coroutine::sleep(0.001)，强制让出控制权 - 重逻辑务必投递到
TaskWorker：启用task_enable_coroutine，并在任务内使用HttpClient::get()等协程 API，避免污染主 Worker
curl_exec（导致协程离线），又累积了静态数组（引发内存缓慢上涨），日志里却只显示“进程卡住”。得先看 swoole_get_local_cid() 是 -1 还是正常值，再决定走阻塞排查还是内存排查路径。
