PHP连数据库90%是配置或权限问题：先查Connection refused/Unknown host确认网络层，再查Access denied核对账号密码和主机限制，MySQL 8+需处理caching_sha2_password兼容性，连接后注意选库、字符集及资源释放。

PHP 连数据库报错，90% 是配置或权限问题，不是代码写错了。先别急着重写 mysqli_connect()，按顺序查这几点，多数能 5 分钟内定位。

看错误信息里有没有 Connection refused 或 Unknown MySQL server host

这是最典型的网络层失败，说明 PHP 根本没连上 MySQL 服务本身：

• Connection refused：MySQL 没启动，或监听的端口（默认 3306）被防火墙拦了，或配置成只监听 127.0.0.1 却用 localhost（部分系统下会走 socket 而非 TCP）
• Unknown MySQL server host：$host 值写错了，比如填了 mysql://xxx、拼错容器名（Docker 环境常见），或 DNS 解析失败（尤其在 Alpine 镜像里缺 resolvconf）
• 临时验证法：在 PHP 服务器上执行 telnet 127.0.0.1 3306 或 nc -zv 127.0.0.1 3306，通了再查账号密码

mysqli_connect(): (HY000/1045): Access denied for user 怎么解

账号密码错、用户不存在、主机限制不匹配，三者占绝大多数：

• 检查 mysqli_connect($host, $user, $password, $dbname, $port) 里 $user 和 $password 是否和 mysql -u xxx -p 登录时一致（注意空格、特殊字符是否被 shell 吃掉）
• 登录 MySQL 执行 SELECT User, Host FROM mysql.user;，确认该用户允许从你的 PHP 所在 IP（如 'myapp'@'172.18.0.%'）连接，不是仅限 'root'@'localhost'
• Docker 或远程环境常见坑：MySQL 用户 Host 设为 %，但 MySQL 8+ 默认用 caching_sha2_password 插件，PHP 7.4 以下不支持——降级插件或升级 PHP

用 PDO 连接却抛出 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client

这是 MySQL 8+ 和旧版 PDO 的经典兼容性冲突，本质是认证协议不匹配：

立即学习“PHP免费学习笔记（深入）”；

• 根本原因：MySQL 8 默认用 caching_sha2_password，而老 PDO 扩展只认 mysql_native_password
• 速修方案（开发环境）：进 MySQL 执行 ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES;
• 长期方案：PHP 升级到 7.4+，并确保 pdo_mysql 扩展已启用（php -m | grep pdo）
• 别碰 default_authentication_plugin 全局改配置——会影响其他应用

连得上但查不出数据，mysqli_connect() 返回 resource 却后续操作失败

这往往不是连接问题，而是连接后没选库、字符集不一致、或连接被意外关闭：

• 显式调用 mysqli_select_db($conn, $dbname)，别依赖 mysqli_connect() 第四个参数——某些旧版本不生效
• 立即执行 mysqli_set_charset($conn, 'utf8mb4')，否则中文存成乱码，查出来也是空或报错
• CLI 模式下注意：如果用了 mysqli_close($conn) 又继续用 $conn，会报 mysqli_query(): Couldn't fetch mysqli ——资源已被释放

真正难排查的，往往是连接成功后因超时、DNS 缓存、SELinux 限制或 MySQL 的 max_connections 耗尽导致的间歇性失败。这类问题得看 SHOW PROCESSLIST 和 MySQL 错误日志，而不是死盯 PHP 报错行。

https://www.php.cn/faq/2035427.html