ThinkPHP 8.0 数据库配置必须显式设置 hostname 为 127.0.0.1（非 localhost）、type 和 database 字段合法，且 MySQL 8.0 空密码需改认证插件为 mysql_native_password，否则易报 SQLSTATE[HY000] 等隐蔽错误。
ThinkPHP 数据库配置不是填完 host、user、pass 就能高枕无忧的事。2026 年真实项目踩坑经验表明：哪怕参数全对，只要 hostname 写成 localhost、type 缺失、password 留空不处理认证插件，TP8 就可能静默失败或报出难以定位的 SQLSTATE 错误。
hostname 必须写 127.0.0.1，别信“localhost 等价”
Windows 下 localhost 默认走命名管道或 IPv6 回环，而 pdo_mysql 扩展（尤其 phpEnv、XAMPP、Docker 环境）只认 IPv4 TCP 连接。结果就是连接超时，或抛出 SQLSTATE[HY000] [2054] 这类认证方法未知错误。
- 统一用 127.0.0.1 替代 localhost，无论 MySQL 在本机还是远程
- 验证方式：写个裸脚本
test_db.php，用new mysqli('127.0.0.1', 'root', '', 'test')直连，输出 OK 才算真正通 - 配置路径是
config/database.php，TP8.0 默认不读.env，除非你手动引入 dotenv
type 和 database 必须显式声明且合法
这两个字段不是“可选”，是初始化 PDO 连接对象的强制契约。漏掉或写错，轻则运行时崩溃，重则错误堆栈藏得深、误判为网络问题。
-
type 必须是小写字符串：
'mysql'、'pgsql'、'sqlite'，大小写敏感；缺失会导致切换数据库类型时驱动未注册直接报错 -
database 对应的库必须已由
CREATE DATABASE创建好，且账号拥有USAGE和SELECT权限；指向不存在的库名，首次查询才抛 Unknown database 'xxx' - 若用
Db::connect()动态传参，数组里也必须带type和database键
password 留空 ≠ 不认证，MySQL 8.0 必须切认证插件
phpEnv、XAMPP、Docker 官方镜像等常见环境，root 默认密码为空，但 MySQL 8.0+ 默认启用 caching_sha2_password 插件——而 PHP 7.4–8.2 自带的 mysqlnd 驱动不支持它，导致 Access denied for user 'root'@'localhost'。
立即学习“PHP免费学习笔记（深入）”；
- 进 MySQL 命令行执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY ''; - 再执行：
FLUSH PRIVILEGES; - 验证：
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';，确认 plugin 列为mysql_native_password
配套增强项：断线重连 + 字段缓存 + 严格检查
这些不是“锦上添花”，而是生产环境稳定运行的基础配置。
- 开启断线重连：
'break_reconnect' => true，避免临时网络抖动导致请求失败 - 启用字段缓存：
'fields_cache' => true，减少每次查询前的元数据探测开销（注意：调试模式下默认禁用，上线前务必关掉app_debug） - 开启严格字段检查：
'fields_strict' => true，防止写入非法字段值被静默忽略
