localhost触发unix socket连接，127.0.0.1强制走tcp/ip；thinkphp默认pdo用localhost导致协议不匹配而拒绝连接，应统一配置为127.0.0.1并确保mysql启用网络监听。
这是因为 localhost 和 127.0.0.1 在 MySQL 底层连接机制中含义不同，而 ThinkPHP 默认走 TCP 连接，但 localhost 会触发 Unix socket 本地域套接字（尤其在 macOS 或 Linux 本地部署时），导致协议不匹配、连接被拒绝。
底层机制差异：localhost ≠ 127.0.0.1
MySQL 客户端遇到 localhost 时，默认优先使用 /tmp/mysql.sock（或 Homebrew 下的 /opt/homebrew/var/mysql/mysql.sock）这类 Unix socket 文件通信；而 127.0.0.1 明确表示走 TCP/IP 协议栈，经过网络层，哪怕本机也走 3306 端口。
ThinkPHP 的 PDO 连接字符串形如：mysql:host=localhost;dbname=xxx，此时 PHP MySQL 扩展会按客户端规则解析为 socket 模式——但你的 mysqld 可能没启用 socket，或路径不对，或配置里禁用了网络（skip-networking = ON），结果就是“连接被拒绝”或“Can't connect to local MySQL server”。
常见触发场景
-
Mac M1/M2 用户用 Homebrew 装 MySQL：默认只监听 socket，
bind-address未设为127.0.0.1，且skip-networking是 ON - Docker 环境下误写 localhost：PHP 容器里的 localhost 指向容器自身，不是宿主机或 MySQL 容器，根本连不到任何 MySQL 实例
-
阿里云/腾讯云 ECS 自建 MySQL：root@localhost 账号仅允许本地 socket 登录，远程（含 127.0.0.1 TCP）会被拒绝，需授权
root@'127.0.0.1'或root@'%'
验证与修复方法
在终端执行这条命令，模拟 ThinkPHP 的连接方式：
mysql -h 127.0.0.1 -P 3306 -u root -p
如果成功，说明 TCP 正常；再试：
mysql -h localhost -u root -p
失败则印证是 socket 问题。修复建议：
- 编辑 MySQL 配置文件（
my.cnf或mysqld.cnf），确保包含：bind-address = 127.0.0.1skip-networking = OFF - 重启 MySQL：
sudo brew services restart mysql（Mac）或systemctl restart mysqld（Linux） - 检查用户权限：
SELECT host, user FROM mysql.user WHERE user='root';，若只有localhost行，就加一条：CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'your_pass'; GRANT ALL ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; - .env 中统一用
DB_HOST=127.0.0.1，避免混用 localhost
补充：Docker 场景下别用 127.0.0.1
这是另一个高频误区：在 docker-compose.yml 里 PHP 和 MySQL 分属不同容器，DB_HOST=127.0.0.1 会让 PHP 容器去连自己（空端口），必须改成 MySQL 服务名（如 db）。所以“能连”是有前提的——仅限于非容器、本地直连 MySQL 的开发环境。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
