CakePHP原生不支持读写分离自动兜底，从库挂了会直接抛PDOException；必须手动try/catch捕获后切主库重试，且读操作需显式指定从库连接或通过重写find()动态切换。
CakePHP 原生不支持读写分离自动兜底，从库挂了就会直接报 PDOException，必须手动捕获并切主库——这不是配置漏了，而是框架根本没实现健康检测和 fallback 逻辑。
为什么配了 read_host 却 select() 还是走主库？
CakePHP（4.x/5.x）的读写分离不是靠配置自动启用的，它依赖显式连接策略。即使你在 config/app.php 的 'Datasources' 里写了多个从库，也必须满足以下条件才会真正走从库：
-
'url'或'host'配置中不能只写一个连接；必须定义至少两个命名连接，比如'default'（主）和'slave'（从） - 所有读操作必须显式调用
Table::getConnection()->useConnection('slave')或在查询时传['connection' => 'slave'] - 模型中未覆盖
$_connectionName，且未在initialize()中硬编码为'default' - 事务未开启（
$this->getConnection()->begin()后所有操作强制走主库）
从库连接失败时怎么不崩、不卡、自动切主？
CakePHP 不会尝试下一个从库，也不会静默 fallback 到主库。它只会抛出类似 PDOException: SQLSTATE[HY000] [2002] Connection refused 的异常。正确做法是把整个查询包进 try/catch，并在捕获后重试主库：
$query = $this->Users->find()->where(['status' => 'active']);
try {
$data = $query->all();
} catch (\PDOException $e) {
if (strpos($e->getMessage(), 'Connection refused') !== false ||
strpos($e->getMessage(), 'No such file or directory') !== false) {
// 切回主库重试
$data = $query->useConnection('default')->all();
} else {
throw $e;
}
}
注意：不要在循环里反复调用 useConnection('slave')，复用同一个 Query 实例即可；也不要对每个字段单独 try/catch，那样会破坏查询上下文。
立即学习“PHP免费学习笔记（深入）”；
如何让 find()/get() 默认走从库，但关键路径强制走主库？
CakePHP 没有全局“读写分离开关”，但可以通过中间件或基类统一控制路由逻辑：
- 在 AppController 的
beforeFilter()中根据 URL 路径判断是否需要强一致性（如/api/order/confirm），然后设置$this->request->setParam('forceMaster', true) - 在 Table 类中重写
find()方法，检查该参数并动态切换连接：return parent::find($type)->useConnection($this->request->getParam('forceMaster') ? 'default' : 'slave'); - 避免在
initialize()中直接改$this->setConnectionName()，因为该方法只影响后续 newQuery()，不改变已构建的 Query 对象
容易被忽略的一点是：get() 方法内部调用了 find('all')，但它默认使用当前 Table 绑定的 connection，不会自动识别你刚在控制器里设的参数——必须在 get 前显式链式调用 ->useConnection()。
