ThinkPHP多数据库连接关键在键名、type、调用方式三者严格对齐：键名须小写+下划线（如'mysql_read'，禁用点号或大写），每个连接必须显式声明'type'（如'mysql'），Db::connect()参数必须为配置键名而非数据库名或模型名，传错即抛异常。
ThinkPHP 多数据库连接不是靠“加几个配置项”就能跑通的，关键在键名、type、调用方式三者必须严格对齐；传错 Db::connect() 的参数或漏写 type，90% 的报错都出在这儿。
database.php 里怎么定义多个连接
每个连接必须是独立键名，且只允许小写字母 + 下划线，不能含点号或大写 —— Db::connect('log.db') 会直接抛异常，正确写法是 'log_db'。
所有连接都必须显式声明 type，哪怕都是 MySQL：不写 'type' => 'mysql'，框架就默认用 MySQL 驱动去解析 PostgreSQL 配置，结果报 Class 'PDO' not found。
常见错误包括：
立即学习“PHP免费学习笔记（深入）”；
- 复制
mysql_write配置后忘了改hostname或database，两个连接实际连向同一台机器 - 把
mysql_read的'write_master' => false漏掉，导致读操作意外触发主库写入 - 用
DB_TYPE这类 ThinkPHP 3 的旧键名，新版已不识别，连接静默失败
示例片段：
'mysql_write' => [
'type' => 'mysql',
'hostname' => '192.168.1.10',
'database' => 'app_main',
'username' => 'root',
'password' => 'xxx',
],
'mysql_read' => [
'type' => 'mysql',
'hostname' => '192.168.1.11',
'database' => 'app_main',
'username' => 'ro_user',
'password' => 'yyy',
'write_master'=> false,
],
Db::connect() 传什么参数才有效
Db::connect() 的参数不是数据库名，也不是模型名，而是 database.php 里定义的连接键名（如 'mysql_read'）；传错就抛 Connection not found: xxx。
它返回的是一个全新 Query 实例，不改变全局默认连接 —— 每次要用，都得显式调用一次。
支持两种传参方式：
- 传字符串：
Db::connect('mysql_read')→ 加载对应配置，走连接池（如果启用） - 传数组：
Db::connect(['type'=>'sqlite','database'=>'/tmp/test.db'])→ 临时连接，绕过配置文件，适合调试或单次轻量操作
绝对不要传：Db::connect('User')、Db::connect('app_main')、Db::connect('default')（除非你真在配置里写了叫 default 的键）。
模型类里 $connection 怎么设才生效
protected $connection = 'mysql_read'; 只在模型类第一次实例化时读取一次，之后改配置、重载 config 文件，这个值也不会刷新。
更关键的是：关联查询（比如 User::with('profile')->select()）不会自动跨库路由 —— 即使 User 绑了 mysql_write，Profile 绑了 mysql_read，with() 仍全部走 User 的连接，不会自动切到 Profile 的库上。
想真正跨库查，只能手动分查：
- 先用
Db::connect('mysql_write')->name('user')->select() - 再用
Db::connect('mysql_read')->name('profile')->where('id','in',$ids)->select() - 最后在 PHP 层做数据合并
SQL Server 连接特别注意 hostname 和 hostport
SQL Server 在 ThinkPHP 中容易连不上，不是密码错，而是地址和端口填法反直觉：
- 填
'hostname' => '127.0.0.1'常报命名管道提供程序: 无法打开与 SQL Server 的连接；换成'hostname' => 'localhost'才行 - 填
'hostport' => '1433'可能报TCP 提供程序: 由于目标计算机积极拒绝,无法连接；留空或设为''反而能连通 -
type必须是'sqlsrv'，不能写成'mssql'或'pdo_sqlsrv'
环境变量覆盖多库配置时，要用二维语法：DATABASE_MYSQL_READ_HOSTNAME=192.168.1.11，而不是扁平的 MYSQL_READ_HOSTNAME。
最常被忽略的一点：连接名一旦写进模型的 $connection，就锁死了；运行中没法热切换。如果业务需要按请求动态路由到不同库（比如租户隔离），别依赖模型属性，老实用 Db::connect($key) 显式控制。
