Hyperf协程调试MySQL需解决超时、结果异常、数据污染三类问题，关键在于SQL行为与协程上下文对齐：绑定协程ID日志、用MAX_EXECUTION_TIME中断慢查、严控连接池复用、参数隔离于协程上下文。

Hyperf 协程环境下调试 MySQL SQL，核心不是“看语句有没有语法错”，而是解决三类真实问题：SQL 执行超时、结果异常（如漏数据/多数据）、协程间数据污染。关键在于把「SQL 行为」和「协程上下文」对齐，避免日志串行、连接复用干扰、超时被掩盖。

开启 SQL 执行日志并绑定协程上下文

默认日志不带协程 ID，多请求并发时 SQL 日志混在一起，根本分不清哪条是当前请求执行的。必须让每条 SQL 日志自动携带 协程 ID 和 请求 ID。

• 确认 config/autoload/logger.php 中已启用 CorrelationId 或手动注入：\Hyperf\Context\Context::get(\Hyperf\HttpMessage\Server\RequestInterface::class)?->getUri()?->getPath()
• 在监听器中捕获 SQL 执行事件，打印结构化日志：
  

  use Hyperf\Database\Events\StatementExecuted;<br>
  public function process(object $event)<br>
  {<br>
      $cid = \Swoole\Coroutine::getuid();<br>
      $sql = $event->sql;<br>
      $time = round($event->time * 1000, 2); // 毫秒<br>
      logger()->info('[SQL] cid={cid} time={time}ms sql={sql}', compact('cid', 'time', 'sql'));<br>
  }

用 MAX_EXECUTION_TIME 主动中断慢查询

协程中一条慢 SQL 可能卡住整个 Worker，但默认 PDO 不报超时异常——它只是等。必须让数据库层主动终止，才能暴露真实瓶颈。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• 在 SQL 中内联 hint（注意格式）：SELECT /*+ MAX_EXECUTION_TIME(2000) */ name FROM users WHERE id = ?
• 单位是毫秒，只对当前语句生效；加号 + 不能省，写成 /* 或 /*! 无效
• 配合日志监听，一旦出现 Query execution was interrupted 错误，立刻定位到具体 SQL 和协程 ID

检查连接池是否复用错连接（尤其读写分离场景）

Hyperf 的连接池默认复用连接，但若事务未正确关闭、或连接被异常占用，后续协程可能拿到残留状态的连接（比如还带着未提交的事务、临时表、用户变量），导致 SQL 行为异常。

• 在 config/autoload/databases.php 中调低空闲回收时间：'max_idle_time' => 30.0（默认 60），减少脏连接滞留
• 强制事务结束时清理：DB::transaction(function () { ... }, 3); 显式设超时，避免无限等待
• 排查时可临时禁用连接复用：'pool' => ['max_connections' => 1]，观察问题是否消失——若消失，说明是连接状态污染

用协程上下文隔离 SQL 参数与行为

别在 Service 属性里存 SQL 条件或分页偏移量。协程共享单例实例，一个请求写入的 $this->where 可能被下一个请求直接读取，造成 SQL 条件错乱。

• 参数全部走方法入参，或用 Context::set('sql_params', [...]) 存于当前协程作用域
• 动态字段（如 ORDER BY $field）必须白名单校验：in_array($field, ['created_at', 'score'], true) ?: 'id'，再拼进 SQL
• 禁止用 Db::raw("{$userInput}")，raw 只用于固定函数或字段名，不用于变量