PHP连接MySQL失败常见原因及解决方法

一分耕耘，一分收获！既然打开了这篇文章《PHP连接MySQL失败怎么处理？常见原因与解决方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

PHP连接MySQL失败主因是服务未运行、权限不匹配或mysqli扩展未启用，需依次检查MySQL状态、端口监听、用户主机匹配及PHP扩展配置。

PHP 连接 MySQL 报错：mysqli_connect() 返回 false 或提示“Connection refused”

绝大多数连接失败，不是代码写错了，而是 mysqli_connect() 根本没连上 MySQL 服务。先确认 MySQL 进程是否在运行、端口是否被监听、防火墙是否放行。

• Linux 下执行 systemctl status mysql（或 mariadb）看服务状态；macOS 用 brew services list | grep mysql
• 检查端口：运行 netstat -tuln | grep :3306 或 lsof -i :3306，若无输出，说明 MySQL 没监听 3306
• 本地测试连通性：mysql -h 127.0.0.1 -P 3306 -u root -p，能进命令行才说明服务可用
• Docker 环境常见坑：host 不能写 localhost，得用 host.docker.internal（Mac/Win）或容器名（同网络下）

报错 “Access denied for user 'xxx'@'localhost'”

用户名密码对不上只是表象，本质是 MySQL 认证用户和来源主机不匹配。MySQL 的用户是 'user'@'host' 二元组，'root'@'localhost' 和 'root'@'127.0.0.1' 是两个不同账号。

• 登录 MySQL 后执行：

  SELECT User, Host FROM mysql.user;

  看是否存在你代码里用的 user + 实际连接时解析出的 host
• 若用 mysqli_connect('localhost', ...)，PHP 默认走 Unix socket（等价于 'user'@'localhost'）；改用 '127.0.0.1' 强制走 TCP，对应 'user'@'127.0.0.1'
• 新创建用户务必用 CREATE USER 'xxx'@'%' IDENTIFIED BY 'pwd'; 并 GRANT ... ON *.* TO 'xxx'@'%';，再 FLUSH PRIVILEGES;

PHP 报 “Call to undefined function mysqli_connect()”

这不是 MySQL 配置问题，是 PHP 编译时没启用 mysqli 扩展，或者扩展没加载。

• 运行 php -m | grep mysqli，无输出说明扩展未启用
• 检查 php.ini 中是否包含 extension=mysqli（Linux/macOS 通常为 extension=mysqli.so，Windows 为 extension=php_mysqli.dll）
• 注意 CLI 和 Web SAPI 的 php.ini 可能不同：用 php --ini 查 CLI 路径，phpinfo(); 查 Apache/Nginx 加载的配置
• Debian/Ubuntu 用户常漏装 php-mysql 包，需 sudo apt install php-mysql

连接成功但查询报 “MySQL server has gone away”

这通常不是连接阶段失败，而是连接后空闲太久被 MySQL 主动断开，或查询超长导致 packet 被截断。

• 检查 MySQL 的 wait_timeout 和 interactive_timeout 值（默认 28800 秒，即 8 小时），短连接场景一般不用调；但长脚本或 CLI 模式下可能触发
• 更常见原因是单次发送 SQL 太大，超过 max_allowed_packet（默认 4MB）。可临时加大：

  SET GLOBAL max_allowed_packet = 64*1024*1024;

• PHP 侧建议：每次查询前加 mysqli_ping($conn) 检测连接有效性，失效则重连；避免复用长时间闲置的连接

MySQL 的权限模型、socket/TCP 差异、PHP 扩展加载路径这三处，最容易被跳过验证，却占了八成以上的“连不上”问题。别急着改代码，先盯住这三块。

终于介绍完啦！小伙伴们，这篇关于《PHP连接MySQL失败常见原因及解决方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！