协程 Context 是解决高并发下数据隔离与生命周期管理的刚需工具；它为每个协程自动绑定独立的 Coroutine\Context 实例，确保 set/get 数据仅当前协程可见，避免静态变量污染、trace_id 串号和资源未释放三类故障。
协程 Context 不是装饰性 API，它是解决高并发下数据隔离与生命周期管理的刚需工具；不主动用，就大概率在 onRequest 中踩到静态变量污染、trace_id 串号、资源未释放三类线上故障。
Co::getContext() 拿到的到底是什么对象
它返回的是 Coroutine\Context 实例，不是全局变量，也不是引用传参后的副本——每个协程启动时自动绑定独立上下文，且只在当前协程内可读写。调用 Co::getContext() 多次返回同一对象，但跨协程调用拿到的是完全不同的实例。
常见错误现象：
- 在
onRequest回调里用static $trace_id存请求 ID，结果多个请求互相覆盖 - 误以为
$ctx = Co::getContext(); $ctx2 = Co::getContext();是两个不同上下文，实际是同一个
使用场景判断要点：
- 必须在协程内调用，否则返回
null（比如在onWorkerStart里直接调用） - 不传参数默认取当前协程上下文；传入
$cid可跨协程读取（仅限同 Worker 进程内，且目标协程尚未退出） - 不能用于跨 Worker 进程通信，那是
Swoole\Table或Redis的职责
set/get 为什么比全局数组更安全
因为底层做了协程 ID 绑定 + 引用计数隔离，$context->set('user_id', 123) 写入的数据只会被当前协程的 $context->get('user_id') 读到，其他协程即使 key 相同也查不到。
对比风险操作：
- 用
$_SERVER['REQUEST_ID']：PHP-FPM 下有效，Swoole 协程中不复存在，且非线程/协程安全 - 用
static $data = []：Worker 进程内所有协程共享，一次写入，全盘污染 - 用
global $ctx_data：全局变量，彻底失控
性能影响极小：set/get 是纯内存哈希表操作，无锁、无系统调用，实测百万次 set+get 耗时约 8ms（Intel Xeon Gold 6248R）。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
Co::defer() 清理资源时怎么正确引用 context 数据
Co::defer() 注册的回调函数，在协程结束前执行，但它捕获的是注册时刻的变量快照——如果直接 use 变量，可能拿不到最新值；必须在 defer 内部重新获取 context 并 get。
错误写法：
$ctx = Co::getContext();
$ctx->set('file_handle', fopen('/tmp/a', 'w'));
Co::defer(function () use ($ctx) {
fclose($ctx->get('file_handle')); // ❌ $ctx 是闭包捕获，但协程退出时它可能已被销毁
});
正确写法：
Co::defer(function () {
$ctx = Co::getContext(); // ✅ 每次 defer 执行时重新获取当前协程上下文
$fh = $ctx->get('file_handle');
if ($fh && is_resource($fh)) {
fclose($fh);
}
});
容易踩的坑：
- defer 回调里不能调用阻塞函数（如
sleep()），否则会卡住整个 Worker - 不能在 defer 中再调用
Co::defer()，嵌套 defer 不被支持 - 协程异常退出（未 catch 的 fatal error）时，defer 仍会执行，但部分资源状态可能已损坏
HTTP 请求链路中 context 如何传递 trace_id 和用户身份
Context 本身不自动透传，必须手动注入。典型模式是在 onRequest 入口统一初始化，后续所有子协程、异步调用都继承该上下文。
关键点：
- 不要在每个函数里重复
Co::getContext()，建议封装一个request_context()工具函数，内部缓存并返回 - 调用外部 HTTP 接口时，需手动把
trace_id注入 header：$client->setHeaders(['X-Trace-ID' => $ctx->get('trace_id')]) - 若下游服务也用 Swoole 协程，可约定 header 透传规则，由对方
onRequest自动提取并 set 到自己的 context
复杂点在于跨协程调用链：比如主协程发起 Co\Http\Client，然后在 go() 里处理响应，这个子协程默认不继承父协程 context —— 必须显式传参或靠 Co::getContext() 在子协程内重新取（它仍是独立上下文，但你可以在子协程里主动 set 同样的 key）。
