PHP 8.5.7 连接 MySQL 超时需先区分建连失败、空闲断连或执行超时三类问题：建连失败查 DNS/网络/防火墙；空闲断连重在 PHP 层主动检测与重建连接，而非仅调大 wait_timeout；执行超时则需优化 SQL 或配置 max_execution_time。
PHP 8.5.7 连接 MySQL 超时，不能只盯着“超时”二字调参数，得先分清是连不上（TCP 建连失败），还是连上了但用着用着断了（空闲被踢），又或是查得太慢（执行卡住）。不同阶段的问题，排查路径和解决方式完全不同。
第一步：确认是“连不上”还是“连上了又断”
看错误信息最直接：
- 出现 Connection timed out、php_network_getaddresses: getaddrinfo failed 或根本没报错只是卡住几十秒——大概率是建连阶段失败，问题在 DNS、网络、防火墙或 MySQL 未监听对应地址端口；
- 出现 MySQL server has gone away、Lost connection to MySQL server during query 或 SQLSTATE[HY000] [2013]——说明连接曾成功建立，但后续复用时已失效，根源通常是 wait_timeout 触发的空闲断连；
- 出现 max_execution_time exceeded 或查询长时间无响应后报错——属于 SQL 执行超时，需查慢查询、锁、索引或 MySQL 的 max_execution_time 配置。
第二步：针对“连不上”，快速验证网络与服务状态
别依赖 PHP 脚本，用最简命令逐层验证：
- 执行 ping -c 3 192.168.1.100（把 IP 换成你的数据库地址），确认基础网络通；
- 执行 telnet 192.168.1.100 3306 或 nc -zv 192.168.1.100 3306，验证 3306 端口是否可访问；
- 登录 MySQL 服务器，运行 sudo ss -tuln | grep :3306，确认 mysqld 正在监听 0.0.0.0:3306（而非仅 127.0.0.1）；
- 检查 MySQL 用户权限：SELECT host FROM mysql.user WHERE user = 'your_user';，确保 host 允许从 PHP 所在机器连接（如 % 或具体 IP）；
- 云环境务必检查安全组/防火墙规则，放行出方向（PHP 机）→ 入方向（MySQL 机）的 3306 端口。
第三步：针对“连上了又断”，重点调客户端逻辑而非盲目改 wait_timeout
MySQL 的 wait_timeout 默认 8 小时，但实测 Web 场景下常 10 秒就断——因为 MySQL 只看 TCP 是否有数据包流动，不看你 PDO 对象还在不在内存里。持久连接（PDO::ATTR_PERSISTENT）也不能绕过这个机制。
立即学习“PHP免费学习笔记（深入）”；
- PHP 8.5.7 推荐做法：在每次执行 SQL 前，主动判断连接是否“新鲜”。例如记录上次使用时间戳，间隔超过 8 秒就重建连接；
- 避免在长生命周期脚本（如 queue:work --daemon）中复用旧连接，unset($pdo) 后 new PDO() 是最稳妥的续命方式；
- 若必须用持久连接，需配合连接健康检查，比如执行一条轻量 SELECT 1，失败则重连；
- 服务端可设 SET GLOBAL wait_timeout = 300;（5 分钟），但关键仍在 PHP 层主动适配，而非指望 MySQL 多等一会儿。
第四步：检查 PHP 侧超时配置是否真正生效
PDO 的 connect_timeout 在 DSN 中写上不一定起作用，尤其用 mysqlnd 驱动时（PHP 8.5.7 默认）：
- mysqli 更可靠：用 mysqli_init() + mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 3) 显式设建连超时；
- PDO 若坚持使用，DSN 中加 ;connect_timeout=3;read_timeout=10;write_timeout=10（PHP 7.4+ 支持），但需确认驱动版本；
- PDO::ATTR_TIMEOUT 仅控制握手阶段，且部分 PHP 版本支持不完整，不建议单独依赖；
- 切忌用 ini_set('default_socket_timeout', 5)，它对 mysqli/PDO 无效，只影响 file_get_contents 等流函数。
