为何网站部署至VPS后仍尝试连接localhost？PHP新手求助

嘿，作为经常帮新手排查VPS数据库连接问题的开发者，我给你列几个最实用的排查步骤，你可以一步步来验证：

• 先确认数据库服务是否正常运行
  首先SSH登录你的VPS，先看看MySQL/MariaDB有没有启动：
  systemctl status mysql（如果是MariaDB就换成systemctl status mariadb）
  如果输出显示inactive (dead)，那就启动服务：systemctl start mysql，顺便设成开机自启避免下次重启又出问题：systemctl enable mysql

• 检查数据库用户的访问权限
  本地开发时数据库用户通常只允许localhost访问，但VPS上要确保你的数据库用户确实被授权从本地（localhost或127.0.0.1）连接。
  登录数据库后执行：
  SELECT user, host FROM mysql.user;
  看看你的目标用户对应的host列是不是localhost或者127.0.0.1（生产环境别用%，不安全）。如果不是，就给用户添加权限：
  GRANT ALL PRIVILEGES ON 你的数据库名.* TO '你的用户名'@'localhost' IDENTIFIED BY '你的密码';
  记得刷新权限让修改生效：FLUSH PRIVILEGES;

• 核对PHP连接代码的每一个参数
  别小看这个，很多时候都是参数细节错了：

  • 主机名：如果PHP和数据库在同一VPS，优先用127.0.0.1代替localhost（有时候localhost会走UNIX socket，而127.0.0.1走TCP连接，更稳定）
  • 用户名/密码：完全匹配VPS数据库里创建的账号，注意大小写（部分系统区分）
  • 数据库名：确保和你在VPS上创建的数据库名称一致
    建议给连接代码加上错误捕获，这样能看到具体报错信息，比如用PDO的话：

  try {
      $pdo = new PDO('mysql:host=127.0.0.1;dbname=你的数据库名;charset=utf8mb4', '你的用户名', '你的密码');
      $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
  } catch(PDOException $e) {
      die("连接失败详情: " . $e->getMessage());
  }
  

  具体的报错信息（比如“访问被拒绝”“数据库不存在”）能帮你快速定位问题。

• 检查防火墙和端口限制
  虽然同一VPS内连接不需要对外开放3306端口，但要确保VPS的防火墙没有阻止本地进程访问3306。如果用UFW防火墙，运行ufw status看看规则；如果是iptables，就检查对应的本地访问规则。

• 排查UNIX Socket路径不匹配问题
  如果坚持用localhost连接，可能会遇到PHP的socket路径和数据库的socket路径不一致的情况。你可以通过phpinfo()查看mysqli.default_socket的值，再对比数据库配置文件（比如/etc/mysql/my.cnf里的socket参数），如果不一样，要么修改PHP配置，要么在连接代码里指定socket路径：

  $mysqli = new mysqli('localhost', '用户名', '密码', '数据库名', null, '/var/run/mysqld/mysqld.sock');
  

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