本地Node.js连接cPanel托管MySQL数据库超时问题求助

排查与解决步骤 #

• 确认数据库端口配置
  cPanel默认MySQL端口为3306，但部分主机商会修改端口。登录cPanel查看数据库管理页面（如远程MySQL设置或phpMyAdmin）获取实际端口，在连接代码中添加port参数：

  function create_connect(){
      var connection = mysql.createConnection({
          host     : '你的域名/IP地址',
          user     : '数据库用户名',
          password : '数据库密码',
          database : '数据库名',
          port     : 3306 // 替换为实际端口号
      });
      connection.connect((err)=>{
          if(err){console.log(err)}
          else{console.log('connected!')}
      });
      return connection;
  }
  

• 检查本地网络拦截
  本地防火墙、杀毒软件或VPN可能拦截3306端口的出站请求。暂时关闭相关软件测试，或在防火墙规则中添加允许访问目标数据库端口的出站权限。

• 验证主机商远程连接权限
  部分主机商默认禁用远程MySQL连接，即使添加IP到白名单也无效。联系主机商客服确认是否开启远程连接权限，以及是否存在额外的IP段限制。

• 测试网络连通性
  使用终端命令测试本地到数据库IP和端口的连通性：

  # telnet测试
  telnet 你的数据库IP 3306
  # nc测试（需安装nc工具）
  nc -zv 你的数据库IP 3306
  

  若命令超时，说明网络层面存在阻塞，优先排查主机商端口限制或本地网络问题。

• 调整连接超时参数
  在连接配置中延长超时时间，避免因网络延迟触发超时：

  var connection = mysql.createConnection({
      // 其他参数
      connectTimeout: 10000 // 设置为10秒，可按需调整
  });
  

• 确认数据库用户远程权限
  确保数据库用户拥有从你的本地IP连接的权限，而非仅localhost权限。可在cPanel用户管理中检查，或通过phpMyAdmin执行授权语句：

  GRANT ALL PRIVILEGES ON dbname.* TO 'username'@'你的本地IP' IDENTIFIED BY 'password';
  FLUSH PRIVILEGES;
  

内容的提问来源于stack exchange，提问作者Om Agrawal