已确认 Hyperf 3.1 中 Swoole 协程 MySQL 真正生效：一查 swoole 扩展是否启用协程且版本 ≥5.0；二验 databases.php 中 driver 必为 mysql 且含合法 pool 配置；三测并发查询耗时约 1 秒而非 2 秒；四观日志使用 Swoole\Coroutine\MySQL 及连接池状态动态变化。
确认 Hyperf 3.1 中 Swoole 协程 MySQL 已真正生效，不能只看扩展是否加载，关键要验证协程环境下的 MySQL 操作是否异步、非阻塞且不挂起 worker。以下是四步精准验证法：
一、检查 Swoole 协程支持是否启用
执行命令：
php --ri swoole
重点查看输出中是否有这两行：
- support coroutines => enabled
- Version => 5.0.0 or higher（Hyperf 3.1 要求 ≥5.0）
若显示 disabled 或版本低于 5.0，说明加载的是旧版 Swoole（如系统自带的 4.x），需重新编译安装并确保 extension=swoole.so 指向新版路径。
二、确认数据库驱动已切换为协程版
打开 config/autoload/databases.php，检查 MySQL 配置块中：
'driver' => 'mysql' —— 这是必须项；
'pool' => [...] —— 必须存在且参数合法（如 min_connections, max_connections）；
不能出现 'driver' => 'pdo' 或 'driver' => 'mysqli'。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
Hyperf 的 hyperf/database 组件在 driver === 'mysql' 时，会自动使用 Swoole\Coroutine\MySQL 客户端；若误配为 PDO，则退化为同步阻塞模式，协程能力完全失效。
三、运行时验证：用 co::sleep + 查询混跑
写一个简单命令行测试脚本（如 test_mysql_coro.php）：
<?php
use Hyperf\Contract\StdoutLoggerInterface;
use Hyperf\Database\Connection;
<p>$container = require_once <strong>DIR</strong> . '/runtime/container.php';
$connection = $container->get(Connection::class);</p><p>go(function () use ($connection) {
// 记录起始时间
$start = microtime(true);</p><pre class="brush:php;toolbar:false;">// 并发发起两个查询（协程内）
$res1 = $connection->select('SELECT SLEEP(1) as t');
$res2 = $connection->select('SELECT SLEEP(1) as t');
echo "协程并发查询总耗时: " . round(microtime(true) - $start, 2) . "s\n";
// ✅ 正常应输出约 1.0–1.2s（两个 SLEEP 并发执行）
// ❌ 若输出约 2.0s+，说明未走协程，是串行阻塞调用});
执行：
php bin/hyperf.php test_mysql_coro
结果接近 1 秒才说明协程 MySQL 真正生效。
四、日志与连接池状态交叉印证
- 启动服务后，观察控制台是否打印类似：
[DEBUG] Using Swoole\Coroutine\MySQL for default pool - 访问
/server/pool（需开启hyperf/server和监控中间件）或执行：
php bin/hyperf.php server:status
查看 MySQL 连接池当前活跃连接数、idle 数是否动态变化；静默无波动或始终为 0，说明连接未被真正创建或复用。
满足以上四点，才能确认 Swoole 协程 MySQL 在 Hyperf 3.1 中已稳定生效。不复杂但容易忽略细节。
