连接失败时应先确认MySQL服务运行状态，再检查PHP mysqli/PDO扩展是否启用、连接参数与网络是否正确、用户权限及host匹配性、socket路径一致性。
如果您在PHP中调用mysqli_connect()或PDO构造函数时返回false或抛出异常，则连接未建立成功。以下是定位与修复该问题的系统性调试步骤：
一、验证MySQL服务运行状态
PHP无法连接MySQL的首要前提是MySQL服务进程未启动，此时所有连接请求均被操作系统直接拒绝。必须确认服务处于active(running)状态。
1、在Linux系统中执行sudo systemctl status mysql或sudo systemctl status mariadb查看服务状态。
2、若输出显示inactive (dead)，则运行sudo systemctl start mysql启动服务。
立即学习“PHP免费学习笔记（深入）”；
3、在macOS上使用Homebrew安装时，执行brew services list | grep mysql确认服务状态；若未运行，执行brew services start mysql。
4、在Windows中打开services.msc，查找MySQL相关服务（如MySQL80、MySQL57），右键选择“启动”并设置为“自动”启动类型。
二、检查PHP MySQL扩展是否启用
当PHP报错Call to undefined function mysqli_connect()或Class 'PDO' not found时，表明对应扩展未加载，与数据库配置无关，纯属PHP运行环境缺失。
1、在命令行中运行php -m | grep -i "mysqli\|pdo_mysql"，若无任何输出，说明扩展未启用。
2、执行php --ini获取CLI模式下的php.ini路径，同时在Web环境中访问phpinfo()页面确认Web SAPI所加载的php.ini位置，二者可能不同。
3、编辑对应php.ini文件，确保存在且未被注释的行：extension=mysqli（Linux/macOS）或extension=php_mysqli.dll（Windows）；PDO需额外确认extension=pdo_mysql已启用。
4、Debian/Ubuntu用户若使用apt安装PHP，需额外安装sudo apt install php-mysql或sudo apt install php-mysqlnd（推荐，支持原生驱动）。
三、确认连接参数与网络可达性
连接参数错误是高频原因，需逐项核验主机、端口、凭证是否与MySQL实际监听配置一致，并排除网络层拦截。
1、在终端执行mysql -h 127.0.0.1 -P 3306 -u root -p进行本地TCP直连测试；若失败，说明服务未监听TCP或凭证错误；若成功，再对比PHP中host是否误写为localhost（可能触发Unix socket路径不匹配）。
2、检查MySQL是否监听3306端口：运行sudo ss -tuln | grep :3306或sudo lsof -i :3306，若无输出，需检查MySQL配置文件中bind-address是否为127.0.0.1或0.0.0.0，而非仅127.0.0.1且被防火墙阻断。
3、云服务器或Docker环境需特别注意：远程连接时MySQL用户host必须为%或具体客户端IP，且MySQL配置中bind-address = 0.0.0.0，同时云平台安全组及本地防火墙（如ufw）须放行3306端口：sudo ufw allow 3306/tcp。
4、Docker容器间连接时，host不可写localhost，应改用host.docker.internal（Mac/Win）或目标容器名（同自定义Docker网络下）。
四、排查用户权限与Host匹配规则
MySQL用户是'user'@'host'二元组，PHP连接时解析出的host必须与mysql.user表中某条记录完全匹配，否则触发Access denied错误，即使密码正确。
1、登录MySQL后执行SELECT User, Host FROM mysql.user;，确认是否存在您代码中使用的用户名，且其Host字段与PHP连接时实际解析的host一致。
2、若PHP使用localhost作为host，MySQL默认走Unix socket，等价于匹配'user'@'localhost'；若使用127.0.0.1，则走TCP，匹配'user'@'127.0.0.1'——二者为不同账号，不可混用。
3、创建新用户时，务必显式指定host：CREATE USER 'webapp'@'%' IDENTIFIED BY 'strong_password';，再授权：GRANT ALL PRIVILEGES ON mydb.* TO 'webapp'@'%'; FLUSH PRIVILEGES;。
4、连接后执行SELECT CURRENT_USER();，可精确获知当前会话匹配的是哪个'user'@'host'条目，用于反向验证。
五、校准PHP与MySQL的Socket路径一致性
当PHP与MySQL均配置为使用Unix socket连接（host=localhost且未指定端口），但双方socket文件路径不一致时，将导致连接失败或警告，尤其在macOS或自定义安装路径的Linux环境中常见。
1、创建一个PHP文件，调用phpinfo();，在浏览器中打开，搜索mysqli.default_socket、pdo_mysql.default_socket和mysql.default_socket三项值。
2、在MySQL命令行中执行STATUS;，在输出中查找UNIX socket行，记录其路径（如/tmp/mysql.sock或/var/run/mysqld/mysqld.sock）。
3、若PHP配置中的socket路径与MySQL实际路径不一致，编辑php.ini，将三项配置统一设为MySQL实际路径：mysqli.default_socket = /tmp/mysql.sock等。
4、修改后重启Web服务器（如Apache或Nginx）及PHP-FPM服务，使配置生效。
