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 的经典兼容性冲突，本质是认证协议不匹配：
PHP5学习对象教程
下载
PHP5学习对象教程由美国人古曼兹、贝肯、瑞桑斯编著，简张桂翻译，电子工业出版社于2007年12月1日出版的关于PHP5应用程序的技术类图书。该书全面介绍了PHP 5中的新功能、编程方法及设计模式，还分析阐述了PHP 5中新的数据库连接处理、错误处理和XML处理等机制，帮助读者系统了解、熟练掌握和高效应用PHP。
立即学习“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 报错行。
