本地无法连接 MySQL 的核心原因依次为：MySQL 未启动或端口非默认；PHP 未启用 mysqli/PDO_MySQL 扩展；连接时误用 localhost 导致走 socket 而非 TCP；MySQL 8.0+ 认证插件不兼容旧版 PHP；用户权限未授权 127.0.0.1。
确认 MySQL 服务已运行且端口可用
本地连不上，90% 的情况是 MySQL 根本没启动，或者监听了非默认端口。Windows 下打开服务管理器查 MySQL80（或你安装时起的名字）是否“正在运行”；macOS/Linux 运行 brew services list 或 sudo systemctl status mysql。别只看图标——用命令验证端口：netstat -an | grep :3306（Linux/macOS）或 netstat -ano | findstr :3306（Windows）。如果没输出，说明 MySQL 没在监听 3306，得去配置文件 my.cnf 或 my.ini 检查 bind-address 和 port 设置。
PHP 必须启用 mysqli 或 PDO_MySQL 扩展
很多本地环境（如 XAMPP、MAMP、Docker）默认不开启 MySQL 扩展，phpinfo() 页面里搜不到 mysqli 就等于 PHP “看不见” MySQL。Windows 用户检查 php.ini 中这两行是否取消注释：extension=mysqli 和 extension=pdo_mysql；macOS 用 Homebrew 安装的 PHP，可能需要手动执行 brew install php@8.2-mysql（版本号按需替换）。改完必须重启 Web 服务（Apache/Nginx/PHP内置服务器），否则无效。
连接代码里别硬写 root 密码，用 127.0.0.1 而非 localhost
这是最常踩的坑：用 localhost 会让 MySQL 尝试走 Unix socket（Linux/macOS）或命名管道（Windows），而 socket 路径不对或权限不足就直接报 Connection refused 或 Access denied。换成 127.0.0.1 强制走 TCP/IP，更可控。
示例（mysqli 面向对象）：
$host = '127.0.0.1';
$port = 3306;
$user = 'root';
$pass = 'your_password_here'; // 别写明文！开发环境也建议用 .env
$db = 'test_db';
<p>$mysqli = new mysqli($host, $user, $pass, $db, $port);
if ($mysqli->connect_error) {
die('连接失败: ' . $mysqli->connect_error);
}注意点：
立即学习“PHP免费学习笔记（深入）”；
-
$port参数不能省略，即使默认 3306 —— 否则mysqli可能忽略 host 直接走 socket - 密码为空时传空字符串
''，不是null或省略 - 如果用的是 MySQL 8.0+ 默认的
caching_sha2_password认证插件，PHP 7.4+ 才原生支持；旧版 PHP 会报Client does not support authentication protocol，得在 MySQL 里给用户切回mysql_native_password：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'xxx';
测试连接前先用命令行验证账号密码和权限
别一上来就跑 PHP 脚本。先终端里敲：mysql -h 127.0.0.1 -P 3306 -u root -p，输入密码看能否登录。如果连这步都失败，问题一定出在 MySQL 用户权限或网络层，跟 PHP 无关。
常见权限问题：
- 用户只允许从
localhost登录，但 PHP 用127.0.0.1连，算不同主机 —— 解决：创建用户时用'root'@'127.0.0.1'或通配'root'@'%'（仅开发） - 数据库不存在，或用户对该库没
SELECT/INSERT权限 —— 用SHOW GRANTS FOR 'root'@'127.0.0.1';看实际权限 - MySQL 8.0 默认禁用远程 root 登录，本地也要显式授权：
CREATE DATABASE IF NOT EXISTS test_db; GRANT ALL ON test_db.* TO 'root'@'127.0.0.1'; FLUSH PRIVILEGES;
socket 路径、认证插件、host 匹配规则、扩展开关——这几个点只要漏一个，连接就会静默失败或报错晦涩。调试时按顺序逐层排除，比反复改 PHP 代码快得多。
