PHP本身不内置连接池，所谓“连接池”实为mysqlnd驱动的持久连接或ProxySQL等代理实现；PDO::ATTR_PERSISTENT仅复用单进程内连接，并非跨请求连接池；需php -i | grep mysqlnd确认mysqlnd版本≥8.0.0，否则启用持久连接将导致泄漏及SQLSTATE[HY000] [2002]错误。
确认连接池是否真正启用
PHP本身不内置连接池，所谓“连接池”实际依赖mysqlnd驱动的持久连接（pconnect）或第三方扩展如pdo-mysqlnd + 连接代理（ProxySQL、MySQL Router）实现。直接在PDO中设置PDO::ATTR_PERSISTENT => true只是复用单个进程内的连接，并非跨请求的连接池。
运行php -i | grep mysqlnd，确认输出含mysqlnd version => 8.0.0 or later；若显示mysqli但无mysqlnd，说明使用的是旧版libmysql驱动，不支持持久连接复用，必须切换。
【未启用mysqlnd时硬启持久连接会导致连接泄漏且报错SQLSTATE[HY000] [2002]】
排查PDO持久连接报错SQLSTATE[HY000] [2002]
该错误表面是“连接被拒绝”，但在启用PDO::ATTR_PERSISTENT后高频出现，本质是连接复用时底层socket已被服务端关闭，而PHP未及时感知。
立即学习“PHP免费学习笔记（深入）”；
方法一：强制禁用持久连接，改用短连接+连接复用层
在DSN中移除PDO::ATTR_PERSISTENT，改用连接池中间件（如ProxySQL），并在其配置中开启mysql-pooling=on。
方法二：保留持久连接但增加心跳检测
在每次执行查询前插入$pdo->query("SELECT 1");，捕获PDOException并重建连接；注意这会增加一次往返开销，仅适用于低QPS场景。
方法三：升级mysqlnd并启用自动重连（PHP 8.1+）
在php.ini中添加：mysqlnd.reconnect = 1，并确保PDO初始化时传入PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"——该指令可触发连接有效性校验。
修复连接池环境下PDO::prepare()失败
第一步：检查预处理语句是否含非法占位符
PDO在持久连接中缓存预处理句柄（prepared statement handle），若同一连接被不同请求复用，且SQL结构差异大（如字段数突变、表名动态拼接），mysqlnd可能因句柄冲突抛出SQLSTATE[HY000]: General error。
第二步：显式关闭预处理句柄
执行完$stmt->execute()后立即调用$stmt = null;，避免句柄残留占用连接资源。
第三步：禁用服务器端预处理（关键）
在DSN中追加;PDO::MYSQL_ATTR_DIRECT_QUERY=1，强制走客户端预处理，绕过MySQL服务器端句柄管理逻辑。此操作会略微降低高并发下预处理性能，但可彻底规避句柄复用冲突。
这一步操作起来很简单，直接修改DSN字符串即可生效，无需重启PHP服务。
验证连接池实际工作状态
登录MySQL服务器，执行：SHOW STATUS LIKE 'Threads_connected';，记录初始值；然后用ab或wrk对PHP接口压测10秒，再次执行该命令。若连接数增长缓慢（如从5→8）而非线性飙升（5→50），说明连接复用生效。
同时检查PHP错误日志：tail -f /var/log/php/error.log | grep -i "persistent"，确认无MySQL server has gone away重复报错。
若压测中出现大量SQLSTATE[HY000] [2013] Lost connection to MySQL server during query，说明连接池空闲超时时间（wait_timeout）小于PHP请求处理耗时，需同步调整MySQL的wait_timeout与interactive_timeout为300秒以上。
