mysqli_connect() 返回 false 的原因需用 mysqli_connect_error() 查看具体错误：Connection refused 表示服务未启动或端口错误；Access denied 是账号密码或 host 权限不匹配；Unknown MySQL server host 是主机名错误或 DNS 不通。
查
返回 false 的具体原因
PHP 连不上数据库，
直接返回
是最常见现象。它不报错，只沉默失败，所以必须主动查错误信息。
立刻在
后加
，比如：
常见输出如
表示服务没启或端口不对；
是账号密码/权限问题；
是主机名写错或 DNS 不通
注意：如果启用了
，错误会抛异常而非返回 false，此时要用
确认 MySQL 服务、端口和网络连通性
PHP 报错只是表象，底层常是服务不可达。别急着改 PHP 代码，先验证基础设施。
用命令行直连测试：
（注意
是大写，指定端口）
若本地能连，但 PHP 用
连不上，大概率是 MySQL 把
解析为 socket 连接，而 PHP 配置了 TCP；换成
就绕过这个问题
检查
确认
mysql
d 确实在监听；
防火墙
（
或
）可能拦了 3306 端口
检查用户权限和 host 匹配规则
错误里最容易被忽略的是
字段——MySQL 用户是
成对存在的，不是只看用户名。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
执行
查看实际用户记录，注意
列是否为
、
、
或具体 IP
PHP 用
连，就必须有
或
；用
连，则需要
新建用户时别漏掉
，否则权限不生效
PDO 连接失败时如何获取详细错误信息
PDO 默认静默失败，错误信息藏得更深，必须显式开启异常模式并捕获。
立即学习
“
PHP免费学习笔记（深入）
”；
创建 PDO 实例时务必传入选项：
这样连接失败会直接抛
，
就是真实错误，比如
表示 socket 路径不对
如果用的是 Unix socket（如
），DSN 中要显式指定
，否则 PDO 可能用错路径
调试时最容易卡在「以为是代码问题，其实是 MySQL 没监听、用户没授权、或 host 不匹配」——这三个点比 PHP 语法出错的概率高得多。
mysqli_connect()mysqli_connect()falsemysqli_connect()mysqli_connect_error()if (!$conn) {
die('连接失败: ' . mysqli_connect_error());
}Connection refusedAccess denied for userUnknown MySQL server hostmysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)try/catchmysql -h 127.0.0.1 -P 3306 -u root -p-Plocalhostlocalhost127.0.0.1netstat -tuln | grep :3306ufwfirewalldAccess deniedhost'user'@'host'SELECT User, Host FROM mysql.user;Host%localhost127.0.0.1127.0.0.1'myuser'@'127.0.0.1''myuser'@'%'localhost'myuser'@'localhost'FLUSH PRIVILEGES;$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);PDOException$e->getMessage()SQLSTATE[HY000] [2002] No such file or directorylocalhostunix_socket=/var/run/mysqld/mysqld.sock