phpEnv下ThinkPHP连接MySQL失败主因是DB_HOST=localhost触发socket连接而phpEnv仅支持TCP，必须改用127.0.0.1；同时需确保.env在根目录、命名规范（如DB_HOST）、密码URL编码，并验证MySQL实际监听端口。
phpEnv 下 ThinkPHP 连接 MySQL 失败，90% 是因为 DB_HOST 写成了 localhost 或环境变量没生效，而不是密码错或端口不通。
为什么 phpEnv 里必须用 127.0.0.1 而不是 localhost
MySQL 在 Windows 下对 localhost 有特殊处理：它会尝试走命名管道或 socket，而 phpEnv 默认只启用 TCP/IP。你看到的 SQLSTATE[HY000] [2002] Connection refused 错误，基本就是这个原因。
-
DB_HOST=localhost→ PHP 尝试连接 MySQL 的 socket 文件（但 phpEnv 没配或路径不对） -
DB_HOST=127.0.0.1→ 明确走 TCP/IP，绕过 socket 问题 - 即使 MySQL 服务在本机，也别信“localhost 更快”——在 phpEnv 场景下它大概率直接失败
.env 配置优先级和常见覆盖陷阱
ThinkPHP 6/8 启用 .env 后，config/database.php 里的 connections.mysql.hostname 等字段会被完全忽略——哪怕你只改了 .env 里一个键，整个连接配置都以它为准。
- 确认
.env文件位于项目根目录，且文件名是.env（不是.env.example或带 BOM） - 必须用
DB_HOST、DB_NAME、DB_USER、DB_PASS这套命名（ThinkPHP 8 默认），不是DB_USERNAME或DB_PASSWORD - 密码含
@、/、:等字符时，必须 URL 编码，例如pa@ss/word→pa%40ss%2Fword - 如果改了
.env没生效，清空runtime/cache/目录再试——ThinkPHP 会缓存配置
phpEnv 中 MySQL 服务状态与端口验证
phpEnv 控制面板显示“MySQL 已启动”，不代表端口真通。本地开发最常踩的坑是 MySQL 实际监听的是 3307 而不是默认 3306（尤其当你装过多个 MySQL 版本）。
立即学习“PHP免费学习笔记（深入）”；
- 打开 phpEnv 安装目录下的
server\mysql\mysql-8.0\my.ini，检查port=值（常见为3306或3307） - 命令行执行
netstat -ano | findstr :3306（把 3306 换成你配置的端口），确认有 LISTENING 状态且 PID 对应 mysqld.exe - 用 Navicat 或 MySQL Workbench 手动连一次：主机填
127.0.0.1、端口填配置值、用户密码同.env，能连上才说明服务没问题 - ThinkPHP 报
Connection refused时，先跳过代码，只做这一步验证
多数据库配置时 Db::connect() 的正确调用方式
想在同一个项目里连两个库，不能靠改 .env 动态切换，必须显式声明连接名并用 Db::connect('mysql2') 获取 Query 实例。
-
.env里加第二组配置，如：DB2_HOST=127.0.0.1、DB2_NAME=gxsjk，然后在config/database.php的connections数组里补全对应项 - 控制器中写
Db::connect('mysql2')->table('user')->select()，不是Db::connect(['hostname' => '...'])—— 后者绕过容器，事务和事件监听会失效 - 不要在模型里硬编码连接名，用
protected $connection = 'mysql2';更安全 - 连接名必须和
config/database.php中connections的键一致，大小写敏感
真正卡住人的往往不是语法，而是 phpEnv 的 MySQL 实际监听端口、.env 的命名规范、以及 localhost 和 127.0.0.1 的底层差异——这三个点对齐了，95% 的连接问题就消失了。
