php连接mysql报错怎么办_连接失败常见原因及解决对策【解答】

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

绝大多数连接失败，不是代码写错了，而是 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）或容器名（同网络下）

用户名密码对不上只是表象，本质是 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;

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