连接失败时先看pdoexception的message字段，它明确指示错误类型：如“2002 connection refused”表示服务未启动，“1045 access denied”说明认证失败，“2002 no such file or directory”指向socket路径问题。
连接失败时，别急着改配置文件——先看 PDOException 的 message 字段，它直接告诉你错在哪。90% 的问题靠这一步就能定位。
看懂 PDOException message 才算真正开始排查
ThinkPHP 不自己抛底层连接错误，真正报错的是 PDO 层。你看到的异常里如果含 PDOException，重点盯住它的 message：
-
"SQLSTATE[HY000] [2002] Connection refused"→ MySQL 服务根本没起来，或端口不通 -
"SQLSTATE[HY000] [1045] Access denied for user"→ 用户名、密码、host 三者中至少一个不匹配 -
"SQLSTATE[HY000] [2002] No such file or directory"→ 误用了 Unix socket（比如 host 写了localhost，但 MySQL 没监听 socket 文件）
验证方式很简单：在项目根目录终端执行
mysql -h 127.0.0.1 -P 3306 -u root -p
这里必须用 127.0.0.1，不是 localhost——后者在 macOS/Linux 下默认走 socket，容易和 PHP 配置错位。
host 和 port 对了还是连不上？检查运行环境差异
Docker、Mac M1、云服务器这三类环境最容易卡在这一步：
- Docker 环境中，
host不能写127.0.0.1或localhost，得换成容器名（如mysql）或宿主机网关（如host.docker.internal） - Mac M1 用 Homebrew 装的 MySQL，默认只监听
/opt/homebrew/var/mysql/mysql.sock；ThinkPHP 默认走 TCP，需确认mysqld开了bind-address = 127.0.0.1且skip-networking = OFF - 阿里云/腾讯云上，除了安全组放行 3306，还要进 MySQL 执行
SELECT host, user FROM mysql.user;，确保对应用户的host是%或具体 IP，不是localhost
.env 配置没生效？三个硬性前提缺一不可
ThinkPHP 6+ 默认读 .env，但它不会自动加载——以下三点必须同时满足：
-
.env文件必须放在项目根目录（和think命令同级），不是app/或config/下 -
APP_DEBUG必须为true，否则环境变量加载逻辑被跳过（这是最常被忽略的一点） -
.env里的键名必须全大写加下划线，如DB_HOST=127.0.0.1，不能写成db_host或Db_Host
验证是否加载成功，控制器里临时加一句：dump(env('DB_HOST'));。输出 null 就说明上面三点至少有一条没做到。
MySQL 8.0+ 报 caching_sha2_password 错误？别降级，改用户认证方式
错误信息类似：Authentication plugin 'caching_sha2_password' cannot be loaded。这不是 ThinkPHP 的锅，是 MySQL 8.0 默认认证插件和老版本 PHP/PDO 不兼容。
解决方法是改用户认证方式，登录 MySQL 后执行：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
注意把 '%' 换成你实际允许连接的 host（如 '127.0.0.1' 或 'localhost'），然后执行 FLUSH PRIVILEGES;。
长期方案是升级 PHP 到 7.4+ 并确认 pdo_mysql 编译时启用了 --with-mysqlnd（运行 php -i | grep "mysqlnd" 可查）。
真正卡住人的地方往往不在“怎么配”，而在“谁在读这个配置”——CLI 和 Web 环境可能用不同 php.ini，Docker 容器内看不到宿主机的 .env，MySQL 用户权限表里写的 localhost 实际拒绝所有 TCP 连接。这些细节不手动验证，光改配置只会循环踩坑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
