升级TP8后数据库连接池报错修复法-ThinkPHP-PHP中文网

thinkphp 8 连接池报错的根本原因是db::table()默认不走连接池，必须显式调用db::pool()->table()；pool配置仅在swoole协程模式（php think swoole）下生效，且需通过config/swoole.php配置、tp≥8.0.12、swoole≥4.8.0及think-swoole≥3.1.0配合，fpm下所有pool设置均无效并加剧连接堆积。

升级tp8后数据库连接池报错修复法

ThinkPHP 8 升级后连接池报错，基本不是配置写错了，而是根本没走连接池——Db::table() 默认不进池，pool 配置写在 database.php 里完全无效，FPM 下硬开 'pool' => true 反而会让连接堆积更严重。

为什么 Db::table() 调用不走连接池

TP8 的连接池不是全局拦截器，它不会自动把所有数据库操作路由过去。你得显式告诉框架：“这次我要用池子”。

Db::table('user')->select() → 每次新建 PDO 实例，走传统短连接
Db::pool()->table('user')->select() → 复用池中空闲连接
模型类（如 UserModel）默认也不走池，除非你在 db() 方法里手动返回 Db::pool() 实例

config/swoole.php 才是唯一有效配置位置

原生 config/database.php 中任何 pool、max_connections 字段都无效；TP8 不原生支持连接池，必须依赖 topthink/think-swoole 扩展，且配置入口只在 config/swoole.php 的 database 节点下：

Quivr

Quivr是一款面向客服团队的 AI 自动回复和工单处理工具。

下载

'database' => [
    'enable' => true,
    'min_connections' => 5,
    'max_connections' => 50,
    'wait_timeout' => 3.0,
    'heartbeat' => 30,
],

enable 必须设为 true，否则其他参数全被忽略
max_connections 是池中最多维持的连接总数（忙碌 + 空闲），不是并发数
wait_timeout 是协程等待空闲连接的超时时间（秒），设太小会频繁抛 ConnectionPoolTimeoutException

FPM 和 Swoole 模式必须严格区分

连接池只在 php think swoole 启动的 Swoole 协程环境中生效；php think run（即 FPM）下所有 pool 配置和 Db::pool() 调用都会静默退化为短连接。

运行模式确认命令：php think env:show | grep APP_MODE，输出 swoole 才对
TP 版本必须 ≥ 8.0.12，早期 8.0.x 存在协程适配 bug，连接不归还
Swoole 扩展版本需 ≥ 4.8.0，think-swoole 需 ≥ 3.1.0

PDO 驱动在协程下有线程安全风险

TP8 默认用 pdo_mysql，但它在协程环境不安全：多个协程共用一个 PDO 实例可能触发 MySQL server has gone away 或字段错乱。

必须切换到 mysqlnd + Swoole\Coroutine\MySQL 兼容层（think-swoole 会自动适配）
验证方式：同一协程内多次调用 Db::pool()->getPdo()，应返回相同 PDO 实例
若仍用 PDO，params 中必须显式传 PDO::ATTR_PERSISTENT => false，生产环境默认禁用持久化

最容易被忽略的一点：三层限制必须对齐——MySQL 的 max_connections、Swoole 的 worker_num、连接池的 max_connections，三者中最小的那个才是实际瓶颈。光调大池子没用，MySQL 拒绝新连接时，报的还是 Too many connections。