PHP无法连接MySQL本质是环境问题：一查MySQL服务是否运行（Linux用systemctl status mysql，Windows查services.msc）；二核对hostname（localhost走socket，127.0.0.1走TCP）；三验端口监听与防火墙；四查用户权限及认证插件兼容性。

这个错误本质是 PHP 无法连上 MySQL 服务，不是 ThinkPHP6 的 bug，而是底层连接环节出了问题。重点不在框架配置，而在环境是否就绪、参数是否匹配、权限是否到位。

先确认 MySQL 服务确实在跑

很多问题其实卡在第一步：数据库根本没启动。

• Linux 下运行 systemctl status mysql 或 systemctl status mysqld，看状态是不是 “active (running)”
• 如果不是，执行 sudo systemctl start mysql 启动；想开机自启就加一句 sudo systemctl enable mysql
• Windows 用户按 Win + R 输入 services.msc，找到 MySQL 相关服务（如 MySQL80），右键“启动”

检查连接地址和协议是否对得上

ThinkPHP6 配置里写的 hostname 很关键，不同写法走的路径完全不同：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 填 localhost：PHP 默认尝试用 Unix socket 连接（Linux/macOS）或命名管道（Windows），不走网络
• 填 127.0.0.1：强制走 TCP/IP 协议，绕过 socket 路径问题，适合排查
• 填域名或远程 IP：要确保 DNS 解析正常、防火墙放行、MySQL 配置允许该 host 连接
• Docker 环境下别写 localhost 或 127.0.0.1，应写 docker-compose.yml 中定义的数据库服务名（比如 db）

验证端口监听和网络通不通

MySQL 默认监听 3306，但可能被改、被绑死、被拦住。

立即学习“PHP免费学习笔记（深入）”；

• Linux 执行 sudo netstat -tulnp | grep :3306，看有没有 mysqld 进程在监听
• 如果只看到 127.0.0.1:3306，远程连不上——编辑 /etc/mysql/mysql.conf.d/mysqld.cnf，把 bind-address = 127.0.0.1 改成 0.0.0.0（注意安全）
• 用 telnet 127.0.0.1 3306 或 nc -zv 127.0.0.1 3306 测试本地端口是否响应；不通就说明服务没监听或被防火墙挡了
• 云服务器（如阿里云、腾讯云）务必检查安全组规则，3306 入方向要放行，且数据库白名单加了应用服务器的内网 IP

核对用户权限和认证方式

即使服务开着、端口通着，账号不对也照样报 2002（尤其 MySQL 8.0+）。

• 登录 MySQL：mysql -u root -p，然后执行 SELECT user, host FROM mysql.user;，确认你要用的账号（比如 thinkphp）的 host 字段是否包含你的来源（%、localhost、具体 IP）
• MySQL 8.0 默认用 caching_sha2_password 插件，老版 PHP 或某些驱动不兼容，可临时改回：ALTER USER 'thinkphp'@'%' IDENTIFIED WITH mysql_native_password BY 'yourpass';
• 如果报错里带 No such file or directory，大概率是 socket 路径不一致：查 MySQL 配置中的 socket = /var/run/mysqld/mysqld.sock，再同步改 PHP 的 pdo_mysql.default_socket（在 php.ini 里）