最常见原因是参数错误或认证插件不兼容；需检查 mysqli_connect() 参数与返回值，用 mysqli_connect_error() 输出错误，验证 MySQL 服务、端口、用户权限、认证插件及 PHP mysqli 扩展是否启用。
检查 mysqli_connect() 的参数和返回值
连不上最常见原因是参数写错，比如把 localhost 写成 127.0.0.1 却没开 TCP 连接，或端口不是默认 3306。PHP 默认用 socket 连 localhost，但 MySQL 8.0+ 可能禁用了匿名用户或改了认证插件，导致空密码或旧用户直接被拒。
实操建议：
- 先用
mysqli_connect('127.0.0.1', 'root', '', 'test')强制走 TCP，绕过 socket 配置问题 - 检查
mysqli_connect()返回值：如果返回false，立刻加mysqli_connect_error()打印错误，别只看白屏 - 确认用户名密码是否真能登录：在终端执行
mysql -u root -p，输密码看能否进；若提示Access denied，说明账号权限或认证方式不匹配
确认 MySQL 服务状态和绑定地址
本地连不上，第一反应不该是改 PHP 代码，而是确认 MySQL 进程真在跑、且监听了预期地址。Windows 下服务可能没启动，macOS/Linux 下可能被 brew 或 docker 的同名服务抢占端口。
实操建议：
- Windows：打开任务管理器 → 服务页，查
MySQL80或你起的服务名是否“正在运行”；或命令行运行sc query mysql - macOS/Linux：运行
ps aux | grep mysqld看进程是否存在；再运行sudo lsof -i :3306确认端口被谁占着 - 检查 MySQL 配置文件（
/etc/my.cnf或/usr/local/etc/my.cnf）里是否有bind-address = 127.0.0.1（正常），但绝不能是bind-address = ::1或空值（某些版本会拒绝 IPv4 连接）
处理 MySQL 8.0+ 默认认证插件变更
PHP 7.4
mysqli 扩展不支持 caching_sha2_password 插件，而 MySQL 8.0 默认就用它。结果就是账号密码没错，连接却静默失败，错误信息可能是 Authentication plugin 'caching_sha2_password' cannot be loaded。
实操建议：
- 临时方案：登录 MySQL 后执行
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';，然后FLUSH PRIVILEGES; - 长期方案：升级 PHP 到 8.0+ 并确保编译时启用了
--with-mysql-sock和对应 OpenSSL 支持；或在连接前加mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);避免卡死 - 验证插件：执行
SELECT user, host, plugin FROM mysql.user WHERE user='root';，确认 plugin 是mysql_native_password
检查 PHP 的 mysqli 扩展是否启用
哪怕 MySQL 服务全 OK，PHP 没装或没启 mysqli 扩展，调用 mysqli_connect() 也会报 Fatal error: Uncaught Error: Call to undefined function mysqli_connect() —— 这类错误容易被当成 MySQL 问题，其实根本没走到连接逻辑。
实操建议：
- 运行
php -m | grep mysqli（命令行）或phpinfo();页面搜索 “mysqli”，确认扩展已加载 - Windows 用户注意
php.ini里是否取消了;extension=mysqli前的分号；macOS 用 brew 安装的 PHP，可能需手动链接扩展配置 - CLI 和 Web SAPI 的
php.ini可能不同：php --ini查 CLI 路径，phpinfo()里看 “Loaded Configuration File” 查 Web 路径
真正卡住的地方往往不在连接语句本身，而在 MySQL 认证机制、socket 文件路径、或 PHP 扩展加载层级这些“看不见”的链路上。每次排查，优先确认服务进程、端口、插件、扩展这四层是否全部对齐，比反复改 mysqli_connect() 参数更省时间。
