PHP数据库查询超时需区分连接超时与执行超时，检查MySQL的wait_timeout、max_execution_time等参数，核对PDO或mysqli的超时配置，排查慢查询、锁竞争及网络中间件问题。
PHP 数据库查询超时，通常不是单一原因导致，而是连接、执行、网络或配置多环节协同作用的结果。关键要区分是“连接超时”还是“查询执行超时”，再结合日志和监控定位具体瓶颈。
检查 MySQL 服务端超时设置
MySQL 自身有多个超时参数，直接影响 PHP 查询行为：
- wait_timeout 和 interactive_timeout：控制空闲连接最大存活时间（单位秒），默认常为 28800（8 小时）。若 PHP 使用长连接且长时间无操作，可能被 MySQL 主动断开，后续查询抛出 “MySQL server has gone away” 错误。
- max_execution_time（仅限 MySQL 8.0.12+）：限制单条语句执行时长，需显式启用并设值，非默认开启。
- net_read_timeout / net_write_timeout：影响数据读写阶段的等待上限，大结果集或慢网络下易触发。
可通过 SHOW VARIABLES LIKE '%timeout%'; 查看当前值，并用 SET SESSION wait_timeout = 300; 临时调整验证。
确认 PHP 端连接与查询超时配置
PHP 不同数据库扩展处理超时的方式不同，需按实际使用方式核对：
立即学习“PHP免费学习笔记（深入）”；
-
PDO（MySQLi 同理）：
PDO::ATTR_TIMEOUT仅控制连接建立超时（如new PDO($dsn, $u, $p, [PDO::ATTR_TIMEOUT => 5])），不控制查询执行超时。执行超时依赖底层驱动及 MySQL 配置。 -
mysqli：支持更细粒度控制：
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 3)设连接超时；mysqli_options($link, MYSQLI_OPT_READ_TIMEOUT, 10)和MYSQLI_OPT_WRITE_TIMEOUT分别设读写超时。 -
PDO + MySQL DSN：可在 DSN 中添加
&connect_timeout=3&read_timeout=10&write_timeout=10（PHP 7.4+ 支持），但实际生效仍受 MySQL 服务端限制。
排查慢查询与锁竞争
多数“超时”本质是查询本身太慢，而非配置过短：
- 开启 MySQL 慢查询日志（
slow_query_log = ON，long_query_time = 1），复现问题后检查是否对应 SQL 入日志。 - 执行
SHOW PROCESSLIST;或查询information_schema.PROCESSLIST，观察超时时是否有大量Locked、Sending data、Copying to tmp table状态。 - 检查执行计划：
EXPLAIN SELECT ...看是否走了索引、是否扫描全表、是否用到临时表或文件排序。 - 注意事务中未提交的写操作可能阻塞后续读，尤其是
SELECT ... FOR UPDATE或长事务。
验证网络与中间件稳定性
跨网段、容器环境或经代理（如 ProxySQL、HAProxy）时，超时可能发生在链路中间：
- 用
ping和telnet db-host 3306（或nc -zv）确认基础连通性与端口可达。 - 若使用连接池或代理，检查其自身超时设置（如 HAProxy 的
timeout connect、timeout server）是否比 PHP 或 MySQL 更激进。 - Docker/K8s 环境中注意 DNS 解析延迟、Service IP 转发、NetworkPolicy 限流等隐形因素，可尝试用 IP 直连绕过 DNS 排查。
定位时优先采集时间戳精确的错误信息（如 “SQLSTATE[HY000]: General error: 2013 Lost connection…”）、对应 SQL、PHP 调用栈、MySQL 错误日志片段。把超时从“黑盒等待”拆解为“哪一跳卡住”，问题就清晰了一半。
