PHP 8.2连MySQL总超时到底哪里配错了？-php教程-PHP中文网

php 8.2 连 mysql 频繁断开主因是多环节超时未对齐：pdo dsn 中 connect_timeout 被 mysqlnd 忽略，需改用 pdo::attr_timeout；云环境 wait_timeout 常被默改为 300 秒，远低于显示值；cli 持久连接与服务端超时冲突；dns ipv6 解析延迟导致假性超时。

php 8.2连mysql总超时到底哪里配错了？

PHP 8.2 连 MySQL 总超时，大概率不是“配错了某一个参数”，而是多个环节的超时机制没对齐，且 PHP 8.2 默认行为和旧版本有关键差异。重点不在“连不上”，而在“连上了又断、用着就挂”——尤其是长任务、队列、CLI 模式下反复报 MySQL server has gone away 或 Connection refused。

下面直击最常踩坑的四个关键点，按优先级排序：

PHP 8.2 的 PDO 默认不认 connect_timeout=5

你可能在 DSN 里写了：

$dsn = "mysql:host=localhost;dbname=test;connect_timeout=5";

但 PHP 8.2 + mysqlnd 驱动下，这个参数被完全忽略（官方已明确说明）。它只对 libmysqlclient 生效，而现代 PHP（包括 8.2）默认用的是 mysqlnd。
✅ 正确做法：

不依赖 DSN 中的 connect_timeout

改用 PDO::ATTR_TIMEOUT（PHP 8.1+ 支持，8.2 稳定可用）：

$options = [
  PDO::ATTR_TIMEOUT => 5, // 单位：秒，控制握手阶段超时
  PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
];
$pdo = new PDO($dsn, $user, $pass, $options);

MySQL 的 wait_timeout 实际生效值远低于你看到的 28800

运行 SHOW VARIABLES LIKE 'wait_timeout'; 看到 28800？别信。
云数据库（如阿里云 RDS、腾讯云 CDB）、Docker 镜像、甚至某些一键安装包，会悄悄把 wait_timeout 改成 300 秒（5 分钟）或更短。而 PHP-FPM worker 或 php think queue:work --daemon 这类长进程，只要空闲超过 5 分钟，连接就被 MySQL 主动 FIN 掉，状态变成 CLOSE_WAIT，但 PHP 还当它是活的。
✅ 查真实值：

SELECT @@global.wait_timeout, @@session.wait_timeout;

✅ 永久修复（推荐设为 600～1800）：
在 /etc/mysql/my.cnf 的 [mysqld] 下加：

wait_timeout = 1800
interactive_timeout = 1800

然后重启 MySQL：sudo systemctl restart mysql

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

CLI 模式下用了持久连接（PDO::ATTR_PERSISTENT），反而更易出错

PHP 8.2 的 CLI 脚本（比如队列、定时任务）如果开了持久连接：

$options[PDO::ATTR_PERSISTENT] = true;

⚠️ 这不会让连接“永不断开”，只会让 PHP 把连接放回池子；MySQL 仍按自己的 wait_timeout 清理它。下次复用时，若连接已被 MySQL 关闭，PDO 不自动重连，直接抛异常。
✅ 安全做法：

CLI/队列脚本禁用持久连接
改为每次执行 SQL 前做轻量检测（不用 ping()，它不可靠）：
```
if ($pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS) === false) {
  throw new RuntimeException('PDO connection lost');
}
```
或更稳妥：封装一个 getFreshPdo()，每次用前判断创建时间是否超 8 秒，超了就重建。