php连接mysql连不上本地服务_php本地mysql连不上排查【方案】_网络技术

最常见原因是参数错误或认证插件不兼容；需检查 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() 参数更省时间。

# mysql # php # linux # word # docker # windows # access # 端口 # ssl # mac # macos # select # Error # mysqli # undefined # function

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】