协程上下文污染导致 MySQL 报错，本质是子协程未继承父协程 Context 数据（如 user_id、trace_id），造成 Context::get() 返回 null，引发空指针、权限校验失败等连锁异常；Hyperf 的 Coroutine::create() 等不自动继承 Context，需手动透传；中间件中禁用 $this->user 等成员变量，改用 Context::set() 避免跨请求数据串流。
协程上下文污染导致 MySQL 报错，本质是子协程启动时没继承父协程的 Context 数据（如 user_id、trace_id），又在后续逻辑里直接调用 Context::get() 拿不到值，进而引发空指针、权限校验失败、SQL 注入防护误判等连锁异常。这不是 MySQL 驱动问题，而是上下文传递断链。
子协程里 Context::get() 返回 null？必须手动透传
Hyperf 的 Coroutine::create()、Co::run()、Co::defer() 均不自动继承父协程 Context。哪怕你在主请求中间件里写了 Context::set('user_id', 123)，子协程一启动，Context::get('user_id') 就是 null。
- 错误写法：
Coroutine::create(function () { $uid = Context::get('user_id'); // 总是 null }); - 正确写法：先捕获再注入 ——
$uid = Context::get('user_id'); Coroutine::create(function () use ($uid) { Context::set('user_id', $uid); /* 后续逻辑 */ }); - 若需透传多个 key，建议打包成数组：
$ctx = ['user_id' => ..., 'request_id' => ...]; Context::set('parent_ctx', $ctx);，子协程内解包复原
MySQL 查询报 PDOException: SQLSTATE[HY000]: General error: 2006 MySQL server has gone away？先查 Context 是否污染连接池
2006 错误表面是连接失效，但在 Hyperf 协程中，90% 是因为上一个协程异常退出前没归还连接，导致该连接卡在协程上下文里被污染（比如残留未 commit 的事务、未释放的 pipeline 状态），下一个协程复用它时直接触发 MySQL 主动断连。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 验证是否泄漏：在疑似位置加日志，检查
Context::has($redis->getContextKey())或对应 MySQL 连接上下文 key 是否长期存在 - 修复重点不是加大
wait_timeout，而是确保每个 DB 操作都在try/catch/finally中显式调用$pdo->rollBack()或$pdo->commit()，并在 finally 里确保连接归还 - 禁用 PDO 缓冲查询（
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false）可减少因大结果集阻塞连接归还的概率
中间件里存了 $this->user，结果多个请求用户信息串流？立刻改用 Context::set()
Hyperf 默认注册中间件为单例（singleton），$this->user 这种成员变量等于跨请求共享内存。A 请求写入，B 请求读取，张三看到李四的订单，不是偶发 bug，是必然行为。
- 立即删除所有
$this->xxx类型的请求级数据存储 - 中间件中统一改用：
Context::set('app.user', $user)（注意加命名空间前缀，避免 key 冲突） - 服务类中读取：
$user = Context::get('app.user') ?? null，不要 fallback 到静态属性或全局变量 - 如必须保留类属性，需在
config/autoload/middlewares.php中将该中间件设为非单例：'singleton' => false
上下文污染最难调试的点在于：它不报错，只悄悄改数据。一次漏传 user_id，可能让后续 5 层嵌套服务都基于错误身份执行，直到最后一条 SQL 插入时才暴露。务必把 Context::set() 和 Context::get() 当作协程内唯一可信的数据通道，其他路径全是雷区。
