thinkphp 8.1 在 swoole 协程下必须配置协程连接池，否则高并发时触发 mysql “too many connections” 错误；需确保 think-swoole ≥ 3.1.0、swoole ≥ 4.8.0、php ≥ 8.1，并在 config/swoole.php 中配置 db_pool，改用 mysqlnd 驱动且禁用 pdo 持久化，查询前必须显式调用 db::pool()。
ThinkPHP 8.1 在 Swoole 协程环境下必须配置协程连接池，否则高并发时会触发 MySQL 的 “Too many connections” 错误，且 PDO 持久化连接在协程中会导致字段错乱或 “MySQL server has gone away” 异常，这不是修改 database.php 就能解决的问题，它依赖扩展版本、驱动类型、配置位置与代码调用方式四者严格对齐。
确认运行环境与依赖
第一步：执行 php think swoole 启动服务，【不是 php think run】；若命令报错或提示 “Command not found”，说明 think-swoole 扩展未安装。
第二步：运行 php -m | grep swoole，确保输出包含 swoole，且版本 ≥ 4.8.0；低于此版本无法支持协程 MySQL 客户端。
第三步：检查 PHP 版本是否为 8.1 或 8.2：php -v；TP8.1 的协程适配层要求 PHP ≥ 8.1，PHP 8.0 或更低版本会跳过协程连接池初始化逻辑。
第四步：确认已安装 topthink/think-swoole ≥ 3.1.0：composer show topthink/think-swoole；旧版（如 3.0.x）存在 Db::pool() 不拦截模型查询的 bug，会导致连接池形同虚设。
配置连接池参数（仅在 config/swoole.php 中生效）
方法一：基础安全配置（推荐新手）
在 config/swoole.php 文件中添加或修改 db_pool 配置块：
'db_pool' => [<br> 'max_active' => 32,<br> 'max_idle' => 8,<br> 'wait_timeout' => 2000,<br> 'idle_timeout' => 60,<br>],
【max_active 是硬上限，不是并发数】；设为 32 表示整个 Worker 进程最多维持 32 条连接（空闲 + 忙碌），超过则排队等待，而非新建连接。
方法二：按压测结果动态调优
先压测获取真实峰值并发请求数（如 ab -n 5000 -c 200），再设 max_active = ceil(峰值并发 × 1.2)；但必须同步检查 MySQL 的 @@max_connections，确保其 ≥ max_active × worker_num，否则多余连接直接被 MySQL 拒绝。
切换 MySQL 驱动为协程安全版本
ThinkPHP 8.1.0 编辑 config/database.php，将数据库类型改为：
'type' => 'mysqlnd',
同时删除所有 'params' => [PDO::ATTR_PERSISTENT => true] 类配置——协程连接池本身已接管复用逻辑，PDO 持久化在此场景下不仅无效，还会干扰连接归还。
代码中显式调用 Db::pool()
① 查询前必须显式调用 Db::pool() 才能启用连接池：
$result = Db::pool()->table('user')->where('id', 1)->find();
② 若使用模型，需在模型类中重写 db() 方法，强制走连接池：
protected function db(): Query<br>{<br> return Db::pool();<br>}
③ 注意：不调用 Db::pool() 时，框架仍走默认 PDO 连接，连接池完全不生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
