PHP 8.0 数据库连接超时本质是TCP建连阶段阻塞，需先通过调试代码确认是否为connect timeout（耗时接近设定值），再依次排查MySQL服务状态、网络通路（telnet/nc）、监听配置（bind_address）、DNS解析（禁用localhost）、驱动兼容性（mysqlnd下PDO::MYSQL_ATTR_CONNECT_TIMEOUT无效）、全局socket超时及连接池耗尽问题。
PHP 8.0 网站数据库连接超时表现为页面卡顿、白屏或报错“SQLSTATE[HY000] [2002] Connection timed out”，实际是 TCP 建连阶段阻塞，不是 SQL 执行慢——必须区分超时发生位置才能快速定位。
第一步：确认超时是否发生在建连阶段
在 PHP 脚本开头插入调试代码，强制捕获底层错误：
```php
ini_set('display_errors', 1);
error_reporting(E_ALL);
try {
$start = microtime(true);
$pdo = new PDO("mysql:host=127.0.0.1;port=3306;dbname=test", "user", "pass", [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_TIMEOUT => 3,
PDO::MYSQL_ATTR_CONNECT_TIMEOUT => 3
]);
$end = microtime(true);
echo "连接耗时：" . round(($end - $start) * 1000, 1) . "ms";
} catch (PDOException $e) {
echo "PDO Error: " . $e->getMessage() . "
Code: " . $e->getCode();
}
若报错信息含 “Connection timed out” 且耗时接近你设的 3 秒，说明确实是建连超时；若报错是 “Connection refused”，则服务根本没响应，跳转到「检查 MySQL 服务与网络通路」环节。
立即学习“PHP免费学习笔记（深入）”；
检查 MySQL 服务与网络通路
方法一：用命令行直连验证（绕过 PHP）
执行：mysql -h 127.0.0.1 -P 3306 -u user -p，输入密码后观察是否秒进。能进 → 问题在 PHP 配置或驱动层；不能进 → 继续排查。
方法二：测试 TCP 连通性
执行：telnet 127.0.0.1 3306 或 nc -zv 127.0.0.1 3306。如果显示 “Connection refused”，说明 mysqld 没监听该地址端口；如果卡住几秒后断开，大概率是防火墙/SELinux/云安全组拦截了 SYN 包——CentOS 7+ 默认 SELinux 会拦 PHP-FPM 的出站连接，临时验证可运行 setenforce 0。
方法三：确认 MySQL 实际监听配置
登录 MySQL 后执行：SHOW VARIABLES LIKE 'bind_address'; 和 SHOW VARIABLES LIKE 'port';。若 bind_address 是 127.0.0.1 但 PHP 用的是域名或 localhost，DNS 解析失败会导致建连卡顿；此时应统一用 IP 地址，并确保 /etc/resolv.conf 中 DNS 可靠，或直接删掉 DNS 查询依赖。
验证 PHP 驱动与超时参数是否生效
第一步：确认你用的是 mysqlnd 驱动（PHP 8.0 默认）
运行 php -i | grep "mysqlnd"，有输出即为 mysqlnd。注意：PDO::MYSQL_ATTR_CONNECT_TIMEOUT 在 mysqlnd 下完全不生效，写了也白写——这是最常踩的坑。
第二步：改用 mysqli_init() 显式设超时（可靠方案）
```php
$mysqli = mysqli_init();
mysqli_options($mysqli, MYSQLI_OPT_CONNECT_TIMEOUT, 3); // ⚠️ 此处才真正控制建连超时
mysqli_options($mysqli, MYSQLI_OPT_READ_TIMEOUT, 5);
mysqli_real_connect($mysqli, '127.0.0.1', 'user', 'pass', 'test', 3306);
```
第三步：检查 php.ini 全局 socket 超时是否冲突
搜索 default_socket_timeout，若它被设成 60，而你代码里只设了 3 秒，仍可能被底层覆盖。建议将此项设为 10（略大于业务超时值），避免意外挂起。
排查 DNS 解析与连接池耗尽
① 把所有 host=localhost 改成 host=127.0.0.1
localhost 在 Linux 下默认走 Unix socket，而 socket 路径错误会报 “No such file or directory”，不是超时；但若系统配置了慢 DNS 且 host 写域名，PHP 会在 connect() 前卡在 getaddrinfo()，导致超时提前触发——这一步能立刻排除 30% 的假性超时。
② 检查 MySQL 当前连接数是否打满
执行：mysql -e "SHOW STATUS LIKE 'Threads_connected';"。若数值接近 max_connections（默认 151），说明连接没释放。常见于 CLI 脚本或高并发请求中反复 new PDO() 却未复用——PDO 实例不会自动 close，必须显式 unset 或用连接池。
③ 查看云环境中间设备是否主动断连
阿里云 RDS、腾讯云 CDB 默认 wait_timeout=300 秒，空闲连接 5 分钟后被服务端杀掉；下次复用该连接就会报超时。解决方法：在 PDO options 中加入 PDO::ATTR_PERSISTENT => true 并配好连接池，或在查询前加 PDO::ATTR_EMULATE_PREPARES => false 避免预处理句柄残留。
