PHP连接外部MySQL数据库超时，试了mysqli、pdo均失败该如何解决？

第一步：确认底层网络连通性 #

• 先在你运行PHP的服务器/本地环境执行telnet命令：telnet 你的MySQL服务器IP 3306，如果连不上直接报超时，就是网络层面不通，和PHP代码无关
• 如果是Windows环境没有telnet，用PowerShell执行：Test-NetConnection 你的MySQL服务器IP -Port 3306
• 确认两个常见网络拦截问题：
  • 你的本地/PHP运行环境的出口防火墙有没有放开3306端口的出站规则
  • 外部MySQL服务器的入站防火墙有没有放开你当前IP的3306端口访问权限

第二步：确认MySQL服务端配置 #

• 检查MySQL的bind-address配置，默认很多MySQL会绑定127.0.0.1只允许本地访问，需要改成0.0.0.0（或者你指定的访问IP段）后重启MySQL服务
• 确认你使用的数据库账号允许你当前的IP访问，MySQL账号默认是只允许localhost登录，需要在MySQL服务端执行授权语句：GRANT ALL PRIVILEGES ON 你的库名.* TO '你的账号'@'你当前的公网IP' IDENTIFIED BY '你的密码'; FLUSH PRIVILEGES;，测试阶段如果不确定IP可以临时写成%允许所有IP访问，生产环境记得改回指定IP。

第三步：排查PHP代码配置问题 #

常规连接参数校验 #

• 确认代码里填写的MySQL服务器IP、端口、账号、密码、库名完全正确，很多场景是端口写错（比如把MySQL的3306写成了网站的80/443）

超时参数调整 #

如果网络延迟较高可以主动延长PHP连接超时时间：

mysqli版本示例

<?php
$servername = "你的外部MySQLIP";
$username = "你的账号";
$password = "你的密码";
$dbname = "你的库名";

// 创建连接时设置超时
$conn = mysqli_init();
$conn->options(MYSQLI_OPT_CONNECT_TIMEOUT, 10); // 设置10秒连接超时，默认通常为2秒
if (!$conn->real_connect($servername, $username, $password, $dbname, 3306)) {
    die("连接失败: " . mysqli_connect_error());
}
echo "连接成功";
?>

PDO版本示例

<?php
$servername = "你的外部MySQLIP";
$username = "你的账号";
$password = "你的密码";
$dbname = "你的库名";

try {
    $conn = new PDO("mysql:host=$servername;dbname=$dbname;port=3306;charset=utf8", $username, $password, [
        PDO::ATTR_TIMEOUT => 10, // 连接超时10秒
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
    ]);
    echo "连接成功";
} catch(PDOException $e) {
    die("连接失败: " . $e->getMessage());
}
?>

特殊场景排查 #

• 如果你的服务器是云服务商提供的（比如阿里云、腾讯云），记得检查云服务商的安全组规则，有没有放开3306端口的出入站权限
• 部分运营商会封禁家庭宽带的3306端口出站请求，如果你是本地家庭网络测试，可以尝试把MySQL服务端的端口改成非3306的其他端口（比如3307）测试

内容的提问来源于stack exchange，提问作者Adalbert Steiner