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 被截断。

立即学习“PHP免费学习笔记（深入）”；

• 检查 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 扩展加载路径这三处，最容易被跳过验证，却占了八成以上的“连不上”问题。别急着改代码，先盯住这三块。