ThinkPHP数据库配置实战：双机热备环境下ThinkPHP的故障转移与自动切换

先说一个很多人容易搞混的核心判断：ThinkPHP 本身并不提供双机热备级别的自动故障转移能力——它只负责应用层的读写分离和连接兜底。所谓的“自动切换”，必须由数据库集群（比如 MHA、Orchestrator、PXC、KingbaseES HA）或系统级高可用工具（corosync + pacemaker）来完成；ThinkPHP 能做的，是感知失败、降级读取、避免雪崩。搞清楚这个边界，后面配置才不会走偏。

主从配置生效但 SELECT 仍走主库？问题出在这两个开关

TP6.0+ 默认关闭自动读路由——即使你配好了从库，Db::table('user')->select() 仍然强制走主库。这不是 bug，而是为事务一致性做的保守设计。解决方式分三种场景：

• 全局启用自动分流：在 config/database.php 对应连接配置中加入 'read_master' => true（注意是布尔值，不是字符串）。
• 单次强制走从库：用 Db::table('user')->master(false)->select()，master(false) 是真正的开关。
• 事务内该调用无效：Db::transaction(function () { Db::table('user')->master(false)->select(); }); 会静默退回到主库，别依赖它做演练验证。

还有一个容易踩的坑：TP6.1+ 要求从库必须嵌套在 'connections' => ['mysql' => [..., 'sla ve' => [...]]] 下。如果你写成平铺式 'sla ve' => [...]，会直接报 Database config "sla ve" not found，排查半天才发现是结构问题。

主库宕机后写操作失败，怎么捕获并兜底？

TP 不会自动把 insert() 切到从库——从库本身不可写，强行切等于制造错误。真正需要验证的是两件事：写失败是否可捕获、读是否可以手动降级。

实践做法：停掉主库（systemctl stop mysqld），然后执行 Db::table('log')->insert(['msg' => 'test'])。预期抛出 PDOException，错误信息含 Connection refused 或 Can't connect to MySQL server。读操作的兜底逻辑可以这样写：

try {
    $data = Db::table('user')->select();
} catch (PDOException $e) {
    if (strpos($e->getMessage(), 'Connection refused') !== false) {
        $data = db('sla ve')->table('user')->select();
    }
}

注意：这个兜底逻辑需要你主动编写，TP 的内核没有内置“故障时自动读从库”机制。

多库切换时连接数暴涨？别在循环里反复调用 Db::connect()

Db::connect('sla ve') 每次都会新建 PDO 实例，不复用、不回收。高频调用的话，Too many connections 很快就会找上门来。

正确做法：提前赋值复用，比如 $sla veDb = Db::connect('sla ve');，后续全部用 $sla veDb->table()->select()。模型里设 protected $connection = 'sla ve' 仅在类加载时读取一次，运行中改配置无效。跨库关联（如 User::with('profile')）也不会自动跳转：Profile 模型仍按自己声明的 $connection 执行，不要指望一个配置统一切换。

另外有个冷知识：迁移命令 php think migrate:run 完全无视模型的 $connection，只认 database.default。如果你的迁移目标不是默认库，得单独指定参数。

双机热备 ≠ ThinkPHP 配置对了就能自动切换

真正的双机热备是基础设施层的事。MySQL 主从复制延迟、VIP 漂移、WAL 同步状态、脑裂防护……这些 ThinkPHP 一概不参与。它只负责在连接建立失败时抛异常，或在你指定下读从库。

如果你正在用 corosync + pacemaker 管理 MySQL 集群，那 VIP 切换后，ThinkPHP 只需连那个固定虚拟 IP 就行；如果你靠 rsync + 自写脚本做文件同步，TP 连的仍是单点地址，根本没机会“切换”。最容易被忽略的一点：所有兜底逻辑（比如读从库、降级返回缓存、返回默认数据）都得你写在业务代码里，TP 的数据库组件不会替你决定“这时候该返回什么”。