PHP 8.3数据库查询超时需分连接建立、查询执行、结果读取三阶段定位：查错误日志关键词区分超时环节；用命令行复现并验证mysqlnd驱动、DSN中connect_timeout参数及php.ini的default_socket_timeout配置；开启慢查询日志、检查wait_timeout、排除DNS解析阻塞；MySQLi调试须在mysqli_real_connect前设置超时选项。
PHP 8.3 网站数据库查询超时不是单一环节卡死，而是连接建立、查询执行、结果读取三阶段中任意一环停滞导致页面白屏或504错误，必须分层定位才能快速修复。
先确认是连接超时还是查询超时
打开 PHP 错误日志（通常在 runtime/log/ 或 /var/log/php_errors.log），搜索关键词：“Connection timed out” 表示卡在建连阶段；“MySQL server has gone away” 或 “Lost connection to MySQL server during query” 表示已连上但查询中途断开；若出现 “Maximum execution time of X seconds exceeded”，说明脚本总时长被截断，需查是否因查询慢拖垮整个脚本。
用命令行复现：在服务器终端执行 php -r "new PDO('mysql:host=127.0.0.1;dbname=test;connect_timeout=3', 'root', '');"，观察是否 3 秒内报错——若卡满 75 秒才失败，说明 PDO 的 connect_timeout 完全未生效，问题出在驱动或配置层面。
检查 PDO 连接超时是否真正起效
方法一：验证 mysqlnd 驱动是否启用
访问 /info.php（含 phpinfo()）页面，搜索 “mysqlnd”。PHP 8.3 默认启用 mysqlnd，但某些定制 phpEnv 或手动编译版本可能仍用 libmysql；若未看到 mysqlnd 版本号，PDO::MYSQL_ATTR_CONNECT_TIMEOUT 必定无效，必须切换驱动或改用 MySQLi。
立即学习“PHP免费学习笔记（深入）”；
方法二：强制在 DSN 中注入 connect_timeout 参数
将数据库 DSN 从 mysql:host=localhost;dbname=test 改为 mysql:host=127.0.0.1;dbname=test;connect_timeout=3。注意：必须把 localhost 换成 127.0.0.1，否则 Windows 下会走 IPv6 回环解析，额外增加 2–5 秒延迟，掩盖真实超时点。
方法三：补全局 socket 超时兜底
编辑 php.ini（路径通常为 phpEnv\php.3\php.ini 或 /etc/php/8.3/cli/php.ini），找到 default_socket_timeout，设为 10；同时确认 mysqli.default_socket_timeout = 10。这两个值必须 ≤ 连接层设置的超时，否则会被底层 socket 阻塞覆盖。
定位查询执行阶段卡顿
第一步：开启 MySQL 慢查询日志
登录 MySQL 执行：
SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 0.5;
再复现一次超时请求，立即去 /var/lib/mysql/hostname-slow.log 查看是否有对应 SQL 记录。有则说明是语句本身慢，不是超时配置问题。
第二步：检查是否触发 wait_timeout 断连
执行 SHOW VARIABLES LIKE 'wait_timeout';，若返回值 ≤ 60，而 PHP 连接池空闲等待时间 > 该值，连接就会被 MySQL 主动关闭。此时 PHP 取到的是一个“假连接”，首次 query 必然报 “MySQL server has gone away”。解决方案：MySQL 端调大 wait_timeout 至 300，PHP 端连接池配置加 'get_timeout' => 10（ThinkPHP）或使用 PDO::ATTR_PERSISTENT => true 并确保连接复用逻辑正确。
第三步：排除 DNS 解析阻塞
在代码中把数据库 host 临时改成 IP 地址（如 127.0.0.1），重启 PHP-FPM 后测试。若超时消失，说明本地 /etc/hosts 或 DNS 服务异常，不能依赖域名解析建连。
MySQLi 替代方案实操（推荐用于调试）
① 初始化连接对象：
$link = mysqli_init();
② 设置连接超时（单位秒，必须在 real_connect 前）：
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 3);
③ 设置读写超时（防止大结果集传输卡住）：
mysqli_options($link, MYSQLI_OPT_READ_TIMEOUT, 8);
mysqli_options($link, MYSQLI_OPT_WRITE_TIMEOUT, 8);
④ 发起真实连接（注意不是 mysqli_connect！）：
mysqli_real_connect($link, '127.0.0.1', 'root', '', 'test', 3306);
这一步漏掉或写成 mysqli_connect()，前面所有超时设置全部失效——这是 PHP 8.3 用户最常踩的坑。
