必须显式设置task_enable_coroutine=>true才能在TaskWorker中使用协程，否则报“Unable to use async-io in task processes”错误；该参数仅Swoole 4.2.12+有效，启用后可在onTask中调用go()、Co::sleep()等，但协程上下文不继承Worker，需自行启动。

协程不能直接在TaskWorker里跑，必须显式开启task_enable_coroutine，否则会报Unable to use async-io in task processes错误。

task_enable_coroutine参数必须手动启用

默认情况下，TaskWorker进程是同步阻塞模型，不支持协程API（如go()、Swoole\Coroutine\MySQL、Co::sleep()）。即使你在Worker里启用了协程，投递到Task里的代码仍会直接崩溃。

• 错误信息典型形式：Unable to use async-io in task processes, please set `task_enable_coroutine` to true
• 必须在$server->set()中显式设置：'task_enable_coroutine' => true
• 该参数仅对Swoole 4.2.12+有效；旧版本（如4.2.11及以下）即使设了也无效
• 启用后，TaskWorker内可安全调用go()、Co::sleep()、Swoole\Coroutine\Http\Client等

投递任务时协程环境自动继承

Worker进程里启动的协程上下文不会传递给TaskWorker——TaskWorker始终从干净的PHP环境开始执行onTask回调。但启用task_enable_coroutine后，你可以在onTask内部重新创建协程，无需额外初始化。

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

• onTask函数本身运行在独立进程里，不是协程，但可立即go(function () { ... })
• 协程内访问的全局变量、静态属性与Worker进程隔离，不存在共享风险
• 注意：Swoole\Runtime::enableCoroutine(true)需在onTask函数体内调用，或确保已在服务启动前全局启用（推荐后者）

协程化IO与CPU密集型任务要分开处理

协程适合IO等待型操作（HTTP请求、Redis查询），但不适合纯计算——它不释放CPU，反而拖慢调度器。TaskWorker才是CPU密集任务的正确归宿。

• ✅ 正确组合：
  – Worker中用协程并发发5个API请求
  – TaskWorker中做图像缩放、大数组JSON编码、正则全文匹配
• ❌ 错误用法：
  – 在TaskWorker里用协程发100个HTTP请求（应由Worker协程并发完成）
  – 在Worker里用sleep(2)模拟延迟（必须改用Co::sleep(2)）
• 性能提示：一个TaskWorker进程内并发太多协程，可能因调度争抢反而降低吞吐；建议单个TaskWorker内协程数控制在10以内

finish()调用时机影响协程生命周期

$server->finish()必须在协程结束后调用，不能在协程中途或未等待完成时调用——否则Worker收不到结果，客户端超时。

• 常见错误写法：go(function () { ... $server->finish($result); }); → 协程异步执行，onTask函数立刻返回，$server已不可用
• 正确写法：用co::wait()或go() + Co::wait()确保协程结束再finish，例如：

  go(function () use ($server, $task_id) {
      $client = new Swoole\Coroutine\Http\Client('api.example.com', 80);
      $client->get('/data');
      $server->finish($client->body); // ✅ 在协程内调用
  });

• 若需多个协程协作后统一返回，用Swoole\Coroutine\WaitGroup比手写co::wait更可靠

真正容易被忽略的是：TaskWorker启用协程后，它的内存模型和错误处理逻辑与Worker完全不同——比如register_shutdown_function在Task里失效，try/catch无法捕获协程内未处理异常，必须靠go()的第三个参数或Co::set(['hook_flags' => SWOOLE_HOOK_ALL])兜底。这些细节不测就上线，很容易在线上静默失败。