协程环境下不能直接复用传统PDO连接，因其底层依赖同步阻塞I/O，会阻塞整个Worker进程导致协程调度假死；必须使用hyperf/pool+hyperf/database构建协程安全连接池，并通过acquire/release显式管理连接生命周期，避免泄漏与事务失效。
协程环境下为什么不能直接复用传统 PDO 连接
因为 PDO 实例本身不是协程安全的：它底层依赖同步阻塞的 socket I/O，在协程调度中会阻塞整个 worker 进程，导致其他协程卡死。Swoole 或 Hyperf 等协程框架要求所有 I/O 操作必须是异步/协程友好的，而原生 PDO 不满足这点。
常见错误现象：Coroutine::sleep() 正常，但一执行 $pdo->query() 就让整个协程调度器“假死”，CPU 占用飙升、请求堆积。
- 别试图给
PDO加go()包裹——没用，阻塞仍在底层发生 - 不要在协程中复用同一个
PDO实例跨协程调用 - 即使用了
swoole_mysql原生协程客户端，它也不自带连接池，需自行管理生命周期
推荐 Composer 库：hyperf/pool + hyperf/database
hyperf/pool 是目前最轻量、侵入性最小、且明确适配协程生命周期的连接池实现；配合 hyperf/database（封装了协程版 PDO 和 swoole_mysql 驱动），能直接复用 Laravel 风格的查询构建器，同时保证连接不泄漏。
关键配置项：max_connections 控制池大小，min_connections 决定预热连接数，wait_timeout 设置获取连接最大等待时间（单位毫秒）。
-
max_connections建议设为数据库服务端max_connections的 60%～70%，避免打满 DB -
wait_timeout不宜过长（如 >5000），否则高并发下协程会长时间挂起 - 务必设置
release_timeout（释放超时），防止连接归还时因异常卡住池子
如何正确初始化一个协程安全的 MySQL 连接池
不能在全局作用域 new 一个连接然后共享，必须由池工厂按需创建、回收。核心是定义一个 ConnectionFactory，实现 Hyperf\Pool\PoolFactoryInterface 接口，返回协程安全的连接实例。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
示例关键片段：
use Hyperf\Database\Connection;
use Hyperf\Pool\PoolFactory;
<p>$factory = make(PoolFactory::class);
$pool = $factory->getPool('mysql', [
'max_connections' => 20,
'min_connections' => 5,
'wait_timeout' => 3000,
'release_timeout' => 1000,
]);</p><p>// 获取连接（协程内调用）
$conn = $pool->get();
try {
$result = $conn->select('SELECT * FROM users WHERE id = ?', [1]);
} finally {
$pool->release($conn); // 必须显式归还
}-
$conn是Hyperf\Database\Connection实例，已自动选择swoole_mysql或pdo_mysql协程驱动 - 忘记
$pool->release($conn)会导致连接泄露，池子逐渐耗尽 - 不要把
$conn存到类属性或静态变量里跨协程复用
连接池 + ORM 使用时的坑：事务与连接绑定
事务必须在同一个连接上完成，而连接池默认不保证“同协程复用同一连接”。如果手动开启事务后，后续查询被分配到另一个连接，就会报错 Lost connection to MySQL server during query 或事务不生效。
解决方式只有两种：
- 用
$pool->acquire()显式锁定连接（推荐）：$conn = $pool->acquire();→ 手动beginTransaction()→ 查询 →commit()→$pool->release($conn) - 启用连接粘性（sticky）模式（Hyperf v3.1+）：配置
'sticky' => true，但仅限单次请求生命周期内有效，不适合长时后台任务 - 避免在事务块里调用其他依赖连接池的服务（比如 Redis 客户端也用了池），否则可能触发死锁
连接池不是银弹——它解决的是连接复用和创建开销，但事务一致性、连接状态清理、超时熔断这些仍需业务层兜底。尤其在异常分支里，release 必须出现在 finally 或 defer 中，少一次就可能拖垮整个池。
