ThinkPHP 5.1+ 中 database.php 的 'type' 必须使用全路径类名加 ::class（如 \think\db\connector\Mysql::class），不再支持 'mysql' 字符串；多库配置中 default 值须严格匹配 connections 键名，Db::connect() 仅接受键名而非配置数组，TP6.0+ 配置由 think-orm 独立包管理，需清理缓存并确保无框架版本冲突。
ThinkPHP 5.1+ 中 database.php 的 'type' 不再支持 'mysql' 字符串写法
旧版 TP5.0 及更早允许在 database.php 中直接写 'type' => 'mysql'，但 5.1+ 已废弃该写法，会报错 Class 'think\db\connector\Mysql' not found 或连接失败。本质是底层改用完整类名映射，字符串类型被移除。
必须改为类名全路径：
'type' => \think\db\connector\Mysql::class,
其他数据库同理：\think\db\connector\Pgsql::class、\think\db\connector\Sqlite::class。
- 不写
::class而直接写字符串（如'type' => 'mysql'）会触发自动加载失败 - 若使用 IDE 自动补全，注意别误补成
think\db\connector\Mysql（缺::class），PHP 会当常量解析并报错Use of undefined constant - TP6.0+ 进一步收紧，连
think\db\connector\Mysql这种字符串写法也彻底不认了，只接受::class形式
多数据库配置里，default 和 connections 的键名必须严格匹配
新版多库配置要求 default 值必须是 connections 数组里的某个键名，且大小写敏感。比如设了 'default' => 'master'，但 connections 里写的是 'Master' => [...]，就会 fallback 到默认 sqlite 配置，查不到表还报 Base table or view not found。
立即学习“PHP免费学习笔记（深入）”；
典型正确结构：
'default' => 'master',
'connections' => [
'master' => [
'type' => \think\db\connector\Mysql::class,
'hostname' => '127.0.0.1',
// ...
],
'slave' => [/* ... */],
],- 键名不要带空格、下划线或中横线（如
'read-slave'在某些版本会因解析异常导致连接失败） - 如果用了环境变量动态配置（如
env('DB_CONNECTION', 'master')），确保环境变量值和connections键名完全一致 - TP6.3+ 对键名校验更严格，非法键名可能直接抛出
InvalidArgumentException
切换数据库时，Db::connect() 的参数不能传配置数组，只能传键名
很多人习惯把整个数据库配置数组传给 Db::connect()，比如 Db::connect(['type' => ..., 'hostname' => ...])，这在新版里已失效——它只会尝试从 connections 中查找该数组的 'name' 键，而不是合并配置。结果是连接默认库，或者报 Connection not found。
正确做法是：先在 connections 中定义好命名连接，再用键名调用：
// ✅ 正确
Db::connect('slave')->table('user')->select();
<p>// ❌ 错误（不会生效）
Db::connect(['hostname' => '192.168.1.100'])->table('user')->select();- 临时连接非配置库，应改用
Db::connect()->setConfig([...])（TP6.2+ 支持），但仅限调试，不建议线上用 - 若需运行时动态选库（如按用户 ID 分库），务必提前在
connections中预定义所有可能的键名，避免运行时拼接键名出错 -
Db::connect('xxx')返回的实例不共享事务上下文，跨连接的startTrans()/commit()无效
TP6.0 升级后，think-orm 独立包导致配置文件位置变化
TP6.0 把数据库组件抽成独立包 topthink/think-orm，配置不再读取 config/database.php，而是走 config/database.php（没错，路径没变），但加载时机和合并逻辑变了：如果项目里还保留旧版 thinkphp/library/think/db/ 相关手动引入，或混用 think\Db 和 think\facade\Db，会出现配置不生效、始终连 sqlite 的现象。
- 确认 composer 中没有残留
"topthink/framework": "5.*"，否则think-orm会被覆盖或冲突 - 删掉
runtime/cache/和runtime/container/，避免旧配置缓存干扰 - 执行
php think optimize:config（TP6.2+）可强制重生成配置缓存，验证是否加载到新配置
最常被忽略的一点：TP6 默认启用连接池，但 connections 里没配 'pool_size' 或 'max_idle_time' 时，会静默降级为单连接模式，压测时才暴露性能瓶颈——不是配置错了，是根本没进池子。
