“connection timed out”根本原因是tcp连接阶段失败，常见于localhost误用、mysql未监听0.0.0.0:3306、防火墙拦截、docker网络配置错误或远程登录未启用；需改用ip、检查监听地址、放行端口、配置用户权限，并用telnet验证连通性。
PHP探针连接 MySQL 时提示“Connection timed out”
根本原因通常是探针脚本发起的 mysqli_connect() 或 PDO::__construct() 在建立 TCP 连接阶段就失败了，不是查询慢，而是连不上服务器。常见于探针部署在容器、云函数或与数据库网络隔离的环境。
- 检查数据库地址是否写成
localhost：它会触发 Unix socket 连接（仅限同机），而实际数据库可能在另一台机器或 Docker 容器里，应改用127.0.0.1或具体 IP - 确认目标 MySQL 实例监听的是
0.0.0.0:3306，而非仅127.0.0.1:3306（后者拒绝外部连接） -
防火墙或安全组是否放行了从 PHP 所在主机到数据库 IP 的
3306端口？云服务器尤其容易漏配 - 某些 MySQL 镜像（如官方
mysql:8.0）默认禁用远程 root 登录，需手动执行CREATE USER+GRANT并刷新权限
PHP探针中 mysqli_connect() 超时时间不可控？
默认情况下，mysqli_connect() 的连接超时由 PHP 内置硬编码控制（Linux 下约 60 秒），无法通过 ini_set('default_socket_timeout', 5) 修改——这个设置只影响 fsockopen() 等流函数，对 mysqli 无效。
- 改用面向对象风格的
mysqli类，并在构造后立即调用options(MYSQLI_OPT_CONNECT_TIMEOUT, 3) - 或直接使用 PDO，它支持在 DSN 中指定
connect_timeout=3，例如：mysql:host=192.168.1.100;port=3306;dbname=test;connect_timeout=3
- 避免在探针里用
mysql_connect()（已废弃且无超时参数）
探针页面显示“MySQL OK”，但实际连的是错库或错用户
很多 PHP 探针只检测 mysqli_connect() 是否返回有效资源，不验证是否真能执行查询。结果是连接成功但权限不足，后续操作全失败。
- 务必追加一次最小代价的验证查询，比如
SELECT 1或SHOW TABLES LIMIT 1 - 检查返回值是否为
mysqli_result对象，而不是false或警告 - 若用 PDO，启用
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则错误会被静默吞掉 - 注意字符集：如果探针连接时未指定
charset=utf8mb4，而数据库默认是utf8mb4，部分旧版探针会因握手失败误报超时
Docker 环境下 PHP 探针连 MySQL 总是超时
这是最典型的网络配置陷阱。Docker 默认桥接网络中，localhost 指向容器自身，不是宿主机，更不是另一个容器。
立即学习“PHP免费学习笔记（深入）”；
- 不要在 PHP 容器里填
localhost或127.0.0.1指向 MySQL 容器；应填 MySQL 容器名（如mysql），前提是二者在同一个自定义网络（docker network create mynet） - 若用
docker-compose.yml，确保depends_on仅控制启动顺序，不解决 DNS 解析延迟——MySQL 容器可能还没 ready，PHP 就开始连，建议在探针脚本里加重试逻辑 - 宿主机运行的 MySQL 若想被容器访问，需绑定到
0.0.0.0，且确认bind-address在my.cnf中未锁定为127.0.0.1
telnet mysql-host 3306 或 nc -zv mysql-host 3306 确认端口可达，再查 PHP 代码。 
