连接cPanel服务器时MySQL出现HY000/2002连接失败问题求助

问题重现 #

警告：mysqli::__construct(): (HY000/2002): 连接尝试失败，因为连接方在一段时间后未正确响应，或已建立的连接失败，因为连接主机未响应。

使用以下PHP代码连接cPanel服务器上的MySQL时出现上述错误：

try{   
    $mysqli = new mysqli('cpanelhost','cpanel_db_user','cpanel_db_password','cpanel_db','port');
    if ($mysqli->connect_errno) { 
        echo "Failed to connect to MySQL: " . $mysqli->connect_error;
        exit();      
    } 
    $sql = "INSERT INTO table (column1, column2) VALUES ('value1', 'value2')";                    
    $mysqli->query($sql) ;      
    $mysqli->close();
}
catch(Exception $e){
    $mysqli->close();
    return $e;  
}

排查与解决步骤 #

1. 核对连接参数的准确性

• 主机地址：如果PHP与MySQL在同一台cPanel服务器，直接用localhost；如果是远程连接，必须使用cPanel后台提供的专用数据库主机地址（通常是类似dbXX.yourhost.com的格式，不要填cPanel面板的登录域名）。
• 端口号：默认MySQL端口为3306，不要留占位符port，直接填写实际端口（cPanel后台可查看）。
• 用户名/密码/库名：必须是cPanel后台创建的数据库专用用户（不是cPanel登录账号），且该用户已被授权访问目标数据库，密码需与创建时完全一致。

2. 配置远程连接权限（跨服务器连接时）

登录cPanel后台，进入MySQL Databases → Remote MySQL：

• 添加你的PHP服务器的公网IP地址（格式：192.168.1.1）；
• 测试阶段可临时填%允许所有IP访问，但生产环境务必限制为指定IP。
• 若PHP与MySQL同服务器，无需配置此项，直接用localhost即可。

3. 检查防火墙与安全组

• cPanel服务器端：确认MySQL端口（默认3306）已在防火墙中开放，允许PHP服务器IP的入站请求；部分主机商会默认禁用远程MySQL连接，需联系主机商开启。
• PHP服务器端：确认本地防火墙允许出站访问MySQL端口。

4. 修复代码中的问题

原代码存在异常捕获无效、变量调用风险等问题，修正后的代码如下：

// 开启mysqli异常模式，让连接错误能被try-catch捕获
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

try{   
    // 替换为实际的正确连接参数
    $mysqli = new mysqli('localhost', 'your_db_username', 'your_db_password', 'your_db_name', 3306);
    
    // SQL语句用反引号包裹表名/字段名，避免关键字冲突
    $sql = "INSERT INTO `table` (`column1`, `column2`) VALUES ('value1', 'value2')";                    
    $mysqli->query($sql);      
    $mysqli->close();
}
catch(Exception $e){
    // 避免未初始化的$mysqli调用close导致报错
    if(isset($mysqli)){
        $mysqli->close();
    }
    echo "连接或执行错误: " . $e->getMessage();
    exit;  
}

内容的提问来源于stack exchange，提问作者Sanamol Explore IT Solutions