workerman协程连接池报错本质是资源生命周期失控：需确保版本≥5.1.0、显式指定eventloop、验证协程环境就绪；redis池须严格get/put且禁共享实例；mysql池须关闭pdo持久化、启用轻量心跳检测；容量应按worker数合理分配并设获取超时。
Workerman协程连接池在高并发场景下频繁出现“Too many connections”或连接卡死，本质是连接未及时归还、超时未回收、或初始化数量远超系统承载能力。这不是代码写错，而是资源生命周期管理失控。
确认连接池驱动与事件循环匹配
第一步：检查 Workerman 版本是否 ≥5.1.0 —— 低于此版本的 Pool 类不支持 Fiber/Swow 等协程驱动下的多连接复用，会退化为单连接串行等待。【低于5.1.0强行使用Pool将导致所有协程阻塞在 getConnection() 上】
第二步：显式指定 eventLoop 类型，不能依赖自动探测。例如使用 Swoole 协程时，必须写 $worker->eventLoop = \Workerman\Events\Swoole::class；若用 Fiber 驱动却没设，底层会 fallback 到 select，而 select 不支持真正的并发连接复用。
第三步：验证驱动是否生效——在 onWorkerStart 回调中 var_dump(\Workerman\Coroutine::getCid())，若返回 int 值（非 false），说明协程环境已就绪；否则连接池创建的连接仍运行在同步阻塞模式。
Redis连接池：创建→获取→归还三步不可省略
方法一：手动管理连接生命周期（推荐用于调试）
① 创建池实例时传入 max_connections 参数，建议初始值设为 8～16，而非盲目设 100。系统默认 ulimit -n 通常为 1024，每个 Redis 连接占用至少 2 个文件描述符（读+写），100 连接即消耗 200+ fd，留足余量给日志、HTTP 连接等其他资源。
② 在业务逻辑中严格遵循「get → use → put」流程：$redis = $pool->get(); → 执行 $redis->set(...) → $pool->put($redis)。漏掉 put 会导致连接永远滞留在“已分配未归还”状态，池中空闲连接数持续下降，最终耗尽。
③ 不要将 $redis 对象存入全局变量或静态属性。协程间共享同一 Redis 实例会引发数据错乱，因为 Redis 扩展本身不是协程安全的。
MySQL连接池：避免 PDO 持久连接与 Pool 双重叠加
切记：PDO 的 ATTR_PERSISTENT => true 与 Workerman Pool 是互斥策略。开启持久连接后，PDO 自己维护连接生命周期，Pool 的 setConnectionCloser 和 heartbeatChecker 将失效，且无法感知连接异常断开。
正确做法是关闭 PDO 持久化，完全交由 Pool 管理：
→ new \PDO($dsn, $user, $pass, [PDO::ATTR_TIMEOUT => 3, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
→ 在 setConnectionCreator 中只做 connect 动作，不要执行任何 query；
→ 必须设置 setHeartbeatChecker：function ($pdo) { $pdo->query('SELECT 1'); }，否则网络闪断后连接长期滞留池中，后续请求拿到的是已失效连接。
【心跳检测 SQL 必须是轻量 SELECT，禁止用 SHOW PROCESSLIST 或复杂语句，否则拖慢整个池的健康检查】
连接池容量动态调节技巧
方法1：根据 Worker 进程数反推最大连接数
若启动了 8 个 Worker 进程，每个进程配一个独立 Pool 实例，则总连接上限 = 单池 max_connections × 进程数。例如单池设 10，8 进程就是 80 连接；若误在全局 new Pool(10) 并被所有进程共享，实际最多只有 10 连接可用，高并发时大量协程排队等待。
方法2：用 context 注入实时负载信号
在 onMessage 中通过 \Workerman\Coroutine\Context::get() 获取当前上下文，结合 \Workerman\Coroutine\WaitGroup 统计并发请求数，当活跃请求数持续 > 单池容量 × 0.8 时，触发日志告警并临时降级部分非核心查询，避免雪崩。
方法3：设置连接获取超时而非无限等待
Pool 构造后调用 $pool->setMaxWaitTime(0.3)，单位秒。超过 300ms 未拿到连接则抛出异常，业务层捕获后可返回 503 或走本地缓存，防止协程无限挂起拖垮整个进程。
