PHP8数据库查询超时主因是socket读取阻塞未受控，需用MySQLi的mysqli_options($mysqli, MYSQLI_OPT_READ_TIMEOUT, 8)设读取超时，或PDO在DSN加read_timeout=10并配mysqlnd驱动，配合服务端SET SESSION wait_timeout双保险。
PHP8数据库查询超时表现为脚本卡在mysqli_query()或PDO::query()调用处，等待数秒至数十秒后抛出“MySQL server has gone away”或直接进程终止，实际是底层socket读取阻塞未受控，不是SQL本身慢。
确认当前查询是否真超时
先排除误判：在PHP8中执行一条已知快速的查询（如SELECT 1），同时用tcpdump抓包观察TCP层是否有SYN重传或RST包。若该查询也卡住，则问题不在SQL逻辑，而在连接建立后、数据读取阶段的socket阻塞——这正是PHP8默认未启用读取超时导致的典型现象。
运行php -v确认版本为8.0+，再检查php --ri mysqli输出中是否含mysqlnd字样；若显示libmysqlclient，则后续PDO超时参数可能被忽略，需切换驱动或改用MySQLi。
MySQLi方式设置读取与写入超时（推荐）
MySQLi在PHP8中对超时控制最稳定，且mysqlnd驱动完全支持：
立即学习“PHP免费学习笔记（深入）”；
第一步：初始化连接后立即调用mysqli_options()设置三项超时：
mysqli_options($mysqli, MYSQLI_OPT_CONNECT_TIMEOUT, 3); —— 控制TCP建连，必须设，否则依赖系统75秒默认值；
mysqli_options($mysqli, MYSQLI_OPT_READ_TIMEOUT, 8); —— 【关键】这是修复查询卡死的核心，它限制从MySQL接收结果集的最大等待时间，PHP8默认为0（无限阻塞）；
mysqli_options($mysqli, MYSQLI_OPT_WRITE_TIMEOUT, 8); —— 防止大INSERT/UPDATE发送阶段挂起。
第二步：确保在mysqli_real_connect()之后、任何query()之前执行上述三行，顺序不能颠倒；若用面向对象风格，必须用$mysqli->options()而非mysqli_options($mysqli, ...)，否则无效。
PDO方式启用查询级超时（需环境匹配）
方法一：仅当使用PHP 8.1+ + MySQL 8.0.12+ + mysqlnd驱动时有效
在DSN中添加;connect_timeout=3;read_timeout=10;write_timeout=10，并显式传入选项数组：
$pdo = new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_CONNECT_TIMEOUT => 3, PDO::MYSQL_ATTR_READ_TIMEOUT => 10, PDO::MYSQL_ATTR_WRITE_TIMEOUT => 10]);
注意：PDO::ATTR_TIMEOUT在mysqlnd下常被忽略，不要依赖它控制查询超时。
方法二：降级兼容方案（PHP 8.0通用）
连接成功后执行SQL指令强制服务端约束：
$pdo->exec("SET SESSION wait_timeout = 10, interactive_timeout = 10"); —— 这能缩短MySQL侧空闲断连阈值，配合客户端读取超时形成双保险。
规避持久连接引发的超时陷阱
若代码中用了mysqli_pconnect()或PDO DSN里加了persistent:true，必须额外处理：
每次复用连接前，执行mysqli_ping($link) === false检测连接有效性；若失效，必须mysqli_close($link)再重建，否则旧连接残留的半开状态会直接导致后续query()无限等待。
不要在循环内反复new PDO()，把实例化提到函数外或用单例管理；否则高频新建连接会迅速耗尽MySQL的max_connections，表现如同超时。
Web服务器层同步调优
① 检查Nginx配置中fastcgi_read_timeout是否小于PHP层设置的读取超时值，例如PHP设了8秒读取超时，而Nginx为5秒，则请求会在到达PHP前就被切断，错误日志里看不到MySQL相关报错；
② Apache环境下，确认php-fpm.conf中request_terminate_timeout大于PHP脚本内set_time_limit()值，否则FPM进程会被强杀，导致连接无法正常关闭，积累TIME_WAIT状态；
③ 执行ss -s | grep "timewait"查看服务器TIME_WAIT连接数，若超65535，需调整内核参数net.ipv4.tcp_tw_reuse = 1并重启网络服务。
