核心原因是MySQL用户表中host字段与ThinkPHP配置的host值不匹配，需执行SELECT User, Host FROM mysql.user WHERE User = '用户名'确认host值，再确保.env配置、权限授予（GRANT）及FLUSH PRIVILEGES全部一致。
![tp5.1数据库配置报sqlstate[hy000] [1045] access denied for user怎么办](https://img.php.cn/upload/article/001/503/042/179065566122971.png)
这个问题核心不是密码输错了，而是 MySQL 用户权限的 host 和 ThinkPHP 实际连接用的 host 不一致。比如数据库里只建了 'user'@'127.0.0.1'，但配置里写了 host => 'localhost'，就会直接拒绝连接。
确认 MySQL 中用户的真实授权记录
别靠猜，进 MySQL 执行这句查清楚：
SELECT User, Host FROM mysql.user WHERE User = '你的用户名';
重点看 Host 字段值：
- 如果是
localhost，PHP 必须用'host' => 'localhost'（走 Unix socket）； - 如果是
127.0.0.1，PHP 就得用'host' => '127.0.0.1'（走 TCP）； - 如果是
%，表示任意 host 都可连（生产环境慎用）； - 如果查不到该用户，说明根本没创建，或用户名拼错了。
检查 .env 配置是否生效且格式正确
TP5.1 依赖 .env 文件加载数据库配置，常见坑有：
- 变量值含空格、特殊字符（如
$、#、:）没加引号，例如DB_PASSWORD=abc$123应写成DB_PASSWORD="abc$123"； - 文件编码不是 UTF-8 无 BOM，导致读取失败，username/password 变成 null；
- 修改后没清缓存，执行
php think clear或手动删runtime/config/下缓存文件。
确保权限已显式授予并刷新
新建用户 ≠ 自动拥有库权限。执行：
SHOW GRANTS FOR '用户名'@'对应Host';
如果返回里没有类似 GRANT ALL ON `your_db`.* TO '用户名'@'Host' 的语句，就补上：
GRANT ALL ON `your_db`.* TO '用户名'@'Host';-
FLUSH PRIVILEGES;（这步不能省，否则不生效）
注意：数据库名带下划线、大小写或特殊字符时，必须用反引号包住，比如 `my_project_db`。
区分 localhost 和 127.0.0.1 的底层行为
TP5.1 的 PDO 连接方式由 host 值决定：
-
'host' => 'localhost'：Linux/macOS 默认走 Unix socket，要求 MySQL 有'user'@'localhost'记录； -
'host' => '127.0.0.1'：强制走 TCP，对应权限记录必须是'user'@'127.0.0.1'； - Docker 或远程部署时，host 很可能是容器名（如
mysql）或内网 IP，权限记录也得匹配那个 host。
