高并发 HTTP 服务中需用协程上下文安全传递请求数据，必须在 co\run() 内初始化、通过 Co::getContext() 存取、避免全局变量，并用 Co::defer 清理资源。
在高并发 HTTP 服务中，一个请求生命周期内需跨多个协程、中间件、数据库查询、日志记录传递用户 ID、trace_id、token 等数据，若直接用全局变量或静态属性，极易引发数据错乱——比如用户 A 的请求被用户 B 的数据覆盖，导致权限校验失败或日志追踪断裂。
确认协程上下文是否已正确初始化
第一步：检查当前代码是否运行在 co\run() 或 Swoole 事件循环内。若在普通 CLI 脚本或 FPM 模式下调用 Context::set()，会触发 Warning: Coroutine is not running，且写入的数据不会绑定到任何协程。
第二步：打印协程 ID 验证环境。执行 var_dump(Co::getCid());，返回整数（如 1）表示已在协程中；返回 false 或 null 则说明尚未进入协程上下文。
第三步：禁止在 onStart、onWorkerStart 等进程级回调中调用 Context::set()——这些阶段没有协程上下文，强行调用无效且掩盖问题根源。
正确设置与读取上下文数据
方法一：使用 Co::getContext() 获取当前协程上下文对象
这一步操作起来很简单，直接调用即可：$ctx = Co::getContext();。注意不要传入 $cid 参数除非你明确要操作其他协程（如子协程读取父协程上下文），否则默认就是当前协程。
方法二：通过键值对安全存取
$ctx->set('user_id', 10086); → echo $ctx->get('user_id');。键名建议统一前缀（如 req.user_id），避免不同模块写入同名 key 导致覆盖。
方法三：使用数组语法快捷操作（Swoole v4.8+）
$ctx['trace_id'] = 'xyz789'; → echo $ctx['trace_id'];。该写法底层仍走 set/get，但更贴近 PHP 原生习惯，无需额外方法调用。
跨函数、跨中间件传递上下文
第一步：在请求入口（如 onRequest 回调）中初始化关键上下文
Context::set('request_id', uniqid('req_', true)); 必须在此处完成，否则后续任意位置都可能读到空值或旧值。
第二步：中间件链中不依赖全局单例，改用上下文注入
传统写法 app('request') 在协程中可能返回错误实例——【ThinkPHP 用户必须改用 think-swoole 提供的 app('request') 封装】，它内部已自动从 Context 中提取 Request 实例，而非 Container 单例。
第三步：自定义服务类中主动获取上下文
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
不要在构造函数里缓存 $this->ctx = Co::getContext();，因为协程切换后该引用可能失效；应在每个方法开头重新调用 Co::getContext() 或封装为 protected 方法：protected function ctx(): Context { return Co::getContext(); }。
协程结束时自动清理资源
使用 Co::defer() 注册清理逻辑，确保临时文件句柄、数据库连接、缓存锁等随协程退出而释放。
Co::defer(function () { $file = Co::getContext()->get('tmp_file'); if ($file) fclose($file); });
注意：defer 函数内使用的变量需通过 use 显式捕获，否则闭包无法访问协程内变量作用域。
避免 EasySwoole3 中的数据混淆陷阱
现象：两个并发请求中，Context::get('user_id') 返回了另一个请求写入的值。
根本原因：未在 co\run() 内启动业务逻辑，或误用 go() 启动协程但未包裹在 co\run() 中——此时 go() 创建的是“游离协程”，其上下文未被 Swoole 正确隔离。
正确写法：
co\run(function () {
Context::set('user_id', 1001);
go(function () {
echo Context::get('user_id'); // 安全输出 1001
});
});
错误写法：go(function () { Context::set('user_id', 1001); }); —— 这段代码若不在 co\run() 内执行，上下文将不可靠。
