ThinkPHP 6 读写分离需配置 connections.mysql 下的 read（数组套数组）和 write（单数组），仅 select()/find() 等读操作走从库，事务/锁/连贯操作异常时回落主库；不支持多连接名下的读写分离，从库故障不自动兜底，需手动捕获异常并切主库。
ThinkPHP 6 的 database.php 怎么配读写分离
ThinkPHP 6 原生支持读写分离，但必须用「主从式」配置，不能靠多个独立数据库名硬切。核心是把 default 设为 'mysql'，再在 connections.mysql 下声明 read 和 write 两个子数组。
常见错误是把 read 写成单个数组（如 ['hostname' => '...']），结果 TP 报错 Call to a member function query() on null —— 因为框架要求 read 必须是数组套数组，哪怕只配一个从库也要写成 [0 => [...]]。
-
write只能有一个，且必须包含完整连接参数（hostname、username、password、database等） -
read是数组，每个元素是一个从库配置；TP 会随机选一个执行查询 - 所有节点的
database名必须一致，否则跨库 JOIN 或事务会出问题 - 如果从库有延迟，
getLastSql()查到的 SQL 可能已在主库执行完，但从库还没同步，导致find()查不到刚save()的数据
什么时候 TP 会走 read 而不是 write
ThinkPHP 不是“所有 select 都走从库”，而是按方法语义判断：只有显式调用 select()、find()、value()、column() 这类纯读操作时才路由到 read；update()、delete()、insert()、save() 强制走 write。
容易踩的坑是用了 where()->find() 却发现走了主库 —— 实际上是因为前面调用了 lock(true) 或开启了事务（startTrans()），TP 在事务中一律禁用读写分离，全部回落到 write。
立即学习“PHP免费学习笔记（深入）”；
- 手动切换可用
$db->master()->select()强制走主库查 -
$db->slave()->insert()语法无效，写操作无法走从库 - 连贯操作中只要出现
order()+limit()+count()组合，TP 有时会误判为写意图，建议拆成两步或加->useReadConnection()
Db::connect() 多连接下读写分离还生效吗
不生效。Db::connect('other_db') 创建的是完全独立的连接实例，它只认自己配置里的 hostname，无视全局 read/write 结构。也就是说，自定义连接名 = 放弃读写分离。
如果你需要对某些表强制走特定从库（比如报表库和业务库物理隔离），正确做法是：在 connections.mysql.read 里把多个从库都列出来，然后靠中间件或模型的 initialize() 动态改 Db::$connection->config(['read' => [...]])，而不是新建连接。
- TP 没有
setReadConnection('slave2')这种 API，强行改 config 是唯一可控方式 - 改 config 后记得清空
Db::$connections缓存，否则下次请求仍用旧配置 - 高并发下频繁改 config 有性能风险，建议配合连接池或提前建好多个预设连接实例
从库挂了，TP 会自动切回主库查吗
不会。默认策略是「死等」—— 尝试连接第一个 read 节点超时后，直接抛出 PDOException: SQLSTATE[HY000] [2002] Connection refused，不会 fallback 到主库，更不会轮到第二个从库。
想实现故障转移，必须自己封装一层：捕获 PDOException 后，临时把当前查询切到 master() 执行，并记录告警。别指望 TP 自动兜底。
- TP 的
break_reconnect配置只控制「连接断开后是否重连」，跟读库失败无关 - 从库健康检查需单独做，比如用定时命令跑
SELECT 1并更新缓存状态 - 最简兜底方案是在模型基类里统一 catch，但要注意避免把主库压力打满
读写分离不是开了配置就万事大吉，路由逻辑藏在框架深处，而故障转移、延迟感知、连接复用这些事，TP 通通交给你自己填。
