php数据库连接超时本质是tcp建连卡住，需从网络、配置、代码三方面解决：mysqli须用mysqli_init()+mysqli_options()设mysqli_opt_connect_timeout；pdo的connect_timeout参数在mysqlnd驱动下常不生效；还需排查dns、防火墙、连接数限制及服务端负载。
PHP数据库连接超时，绝大多数情况不是网络不通，而是 mysqli_connect() 或 PDO::__construct() 卡在 TCP 建连阶段——等了 30 秒、60 秒甚至 75 秒才失败。这个时间根本不是你代码里写的“超时”，而是系统默认兜底值。
mysqli_connect() 为什么设不了超时参数
mysqli_connect() 函数本身不接受超时参数，它直接调用底层 socket connect，最终依赖操作系统 TCP 连接超时（Linux 默认 75 秒）。你写 mysqli_connect($host, $user, $pass, $db, $port)，哪怕 $host 是错的或被防火墙拦了，也会傻等到底。
- 必须改用
mysqli_init()+mysqli_options()+mysqli_real_connect()三步法，其中MYSQLI_OPT_CONNECT_TIMEOUT才真正生效 -
MYSQLI_OPT_CONNECT_TIMEOUT只管 TCP 握手，不管 DNS 解析——如果/etc/resolv.conf配得慢或域名不可达，它会在 DNS 阶段就失败，且错误信息可能只是 “Connection refused” - 别用域名连生产库，
$host直接填 IP，能绕过 DNS 不确定性
PDO 的 connect_timeout=5 为什么经常不生效
你在 DSN 里写 "mysql:host=localhost;port=3306;dbname=test;connect_timeout=5"，但实际还是卡 30 秒？大概率是以下原因：
- PHP 用的是 mysqlnd 驱动（默认），它完全忽略 DSN 中的
connect_timeout参数 - 只有 libmysqlclient 驱动（已逐步淘汰）才支持该参数，且依赖 MySQL 客户端库版本
- PHP 8.1+ 起部分版本支持
PDO::ATTR_TIMEOUT，但仅限于某些构建方式，不能无脑依赖 - 更可靠的做法：换
mysqli，或在 CLI/队列脚本中用stream_context_create()包一层 socket（不推荐，太重）
报 “MySQL server has gone away” 其实和建连超时无关
这个错误（SQLSTATE[HY000] [2006]）不是连不上，而是连上了、用了一阵子、然后被 MySQL 主动断开了。根源是服务端的 wait_timeout 参数——比如云数据库 RDS 默认只设 300 秒，你的 ThinkPHP 队列 worker 启动后空闲 6 分钟，再查库就崩。
- 查当前值：
SHOW VARIABLES LIKE 'wait_timeout'; - 临时调：
SET SESSION wait_timeout = 300;（当前连接生效） - 永久改：在 MySQL 配置文件
[mysqld]段加wait_timeout = 300，然后重启 mysqld - ThinkPHP 等框架要开
break_reconnect，并在执行前主动ping()或捕获 2006 错误后重连
Docker 或云环境里最容易漏掉的两点
本地跑得好好的，一上容器或云服务就超时，往往卡在基础设施层：
- Docker 默认 bridge 网络不支持服务名解析——PHP 容器里写
host: mysql，其实根本 resolve 不出 IP；必须用docker network create自建网络，让两个容器走同一子网 - 云厂商 SLB / 安全组 / NAT 网关会主动 kill 半开连接（SYN_SENT 状态卡住），表现就是随机超时、无明确错误；得用
tcpdump -i any port 3306抓包确认是否 SYN 包发出去就没回音
真正难定位的是组合问题：DNS 缓存刚过期 + MySQL 正好 CPU 100% + 中间防火墙启用了连接跟踪老化，三者叠加时，错误日志里可能只显示一句模糊的 “Connection timed out”，而每个环节单独看都正常。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
