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