PHP数据库连接失败需按服务→参数→权限→扩展→网络顺序排查：先确认MySQL服务运行及端口监听，再核对host/port/账号密码，检查'user'@'host'权限匹配，确保mysqli/pdo_mysql扩展启用，并验证防火墙与认证插件兼容性。
PHPEnv（如phpStudy、XAMPP、Wamp等一键环境）数据库连接失败，不是“玄学”，而是几个关键环节出了偏差。核心思路是：先让连接失败报出具体错误，再按服务→参数→权限→扩展→网络的顺序逐层验证。
立即捕获真实错误信息
别只写 mysqli_connect() 就运行，必须检查返回值并输出错误详情：
- 在连接代码后加判断：
if (!$conn) { echo "连接失败：" . mysqli_connect_error(); exit; } - 常见错误含义直读：
• “Connection refused” → MySQL没启动或端口不通
• “Access denied for user” → 用户名/密码错，或 host 不匹配
• “Unknown MySQL server host” → 主机名无法解析（比如填了错的域名或IP）
• “No such file or directory” → 用 localhost 时找不到 socket 文件，换 127.0.0.1 即可
确认MySQL服务已就绪且监听正确
一键环境里MySQL看似“绿色”不等于真在工作：
- 打开phpStudy/XAMPP控制面板，看MySQL状态是否为“已启动”；若启动失败，点“日志”查看
mysql_error.log中的报错 - 命令行验证服务是否存活：
Windows：运行netstat -ano | findstr :3306
Linux/macOS：运行lsof -i:3306或ss -tlnp | grep 3306 - 检查MySQL是否绑定了正确地址：
打开my.cnf（通常在 phpEnv 安装目录的mysql/bin/my.ini或etc/my.cnf），确认没有skip-networking，且bind-address是127.0.0.1或0.0.0.0（非仅127.0.0.1才支持远程）
核对连接参数与用户授权细节
账号密码对 ≠ 能连上，关键是 'user'@'host' 这个组合要完全匹配：
立即学习“PHP免费学习笔记（深入）”；
- 用 phpMyAdmin 或命令行登录MySQL：
mysql -u root -p，执行：SELECT User, Host FROM mysql.user;
看你要用的用户（如 root）对应的 Host 是localhost、127.0.0.1还是% - 本地测试建议统一用
127.0.0.1（强制TCP），避免localhost因 socket 路径问题导致行为不一致 - 如果PHP和MySQL不在同一机器（如Docker或局域网），用户 Host 必须是具体IP或
%，并执行：GRANT ALL ON your_db.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;
检查PHP扩展是否启用及兼容性
尤其在升级PHP版本后，这是高频盲区：
- 运行
php -m | grep -i mysqli（Linux/macOS）或php -m（Windows，人工查找），确认mysqli和pdo_mysql已加载 - 打开
php.ini，确保以下两行未被注释：extension=mysqliextension=pdo_mysql
（Windows下对应php_mysqli.dll和php_pdo_mysql.dll） - PHP 8.0+ 连 MySQL 8.0+ 时，默认认证插件
caching_sha2_password可能不兼容旧驱动，临时改用：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES;
