PHP连接数据库失败怎么查？常见错误解决方法

怎么入门文章编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《PHP连接数据库失败怎么查？数据库调试错误汇总》，涉及到，有需要的可以收藏一下

mysqli_connect() 返回 false 的原因需用 mysqli_connect_error() 查看具体错误：Connection refused 表示服务未启动或端口错误；Access denied 是账号密码或 host 权限不匹配；Unknown MySQL server host 是主机名错误或 DNS 不通。

查 mysqli_connect() 返回 false 的具体原因

PHP 连不上数据库，mysqli_connect() 直接返回 false 是最常见现象。它不报错，只沉默失败，所以必须主动查错误信息。

• 立刻在 mysqli_connect() 后加 mysqli_connect_error()，比如：

  if (!$conn) {
      die('连接失败: ' . mysqli_connect_error());
  }

• 常见输出如 Connection refused 表示服务没启或端口不对；Access denied for user 是账号密码/权限问题；Unknown MySQL server host 是主机名写错或 DNS 不通
• 注意：如果启用了 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)，错误会抛异常而非返回 false，此时要用 try/catch

确认 MySQL 服务、端口和网络连通性

PHP 报错只是表象，底层常是服务不可达。别急着改 PHP 代码，先验证基础设施。

• 用命令行直连测试：mysql -h 127.0.0.1 -P 3306 -u root -p（注意 -P 是大写，指定端口）
• 若本地能连，但 PHP 用 localhost 连不上，大概率是 MySQL 把 localhost 解析为 socket 连接，而 PHP 配置了 TCP；换成 127.0.0.1 就绕过这个问题
• 检查 netstat -tuln | grep :3306 确认 mysqld 确实在监听；防火墙（ufw 或 firewalld）可能拦了 3306 端口

检查用户权限和 host 匹配规则

Access denied 错误里最容易被忽略的是 host 字段——MySQL 用户是 'user'@'host' 成对存在的，不是只看用户名。

• 执行 SELECT User, Host FROM mysql.user; 查看实际用户记录，注意 Host 列是否为 %、localhost、127.0.0.1 或具体 IP
• PHP 用 127.0.0.1 连，就必须有 'myuser'@'127.0.0.1' 或 'myuser'@'%'；用 localhost 连，则需要 'myuser'@'localhost'
• 新建用户时别漏掉 FLUSH PRIVILEGES;，否则权限不生效

PDO 连接失败时如何获取详细错误信息

PDO 默认静默失败，错误信息藏得更深，必须显式开启异常模式并捕获。

• 创建 PDO 实例时务必传入选项：

  $pdo = new PDO($dsn, $user, $pass, [
      PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
  ]);

• 这样连接失败会直接抛 PDOException，$e->getMessage() 就是真实错误，比如 SQLSTATE[HY000] [2002] No such file or directory 表示 socket 路径不对
• 如果用的是 Unix socket（如 localhost），DSN 中要显式指定 unix_socket=/var/run/mysqld/mysqld.sock，否则 PDO 可能用错路径

调试时最容易卡在「以为是代码问题，其实是 MySQL 没监听、用户没授权、或 host 不匹配」——这三个点比 PHP 语法出错的概率高得多。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP连接数据库失败怎么查？常见错误解决方法》文章吧，也可关注golang学习网公众号了解相关技术文章。