如何详细配置ThinkPHP中的数据库读写分离机制？

本文共计1292个文字，预计阅读时间需要6分钟。

如果在ThinkPHP应用中将读操作分发给数据库，但配置后查询仍全部走向主库，可能是由于以下原因：

一、ThinkPHP 6.0+ 启用 deploy + rw_separate 模式

该模式为TP6官方推荐方式，通过部署模式控制主从路由，读写分离行为与模型操作强绑定，需确保配置层级和键名完全正确。

1、打开 config/database.php 文件，在 connections 数组内定义名为 'mysql' 的连接配置。

2、在该连接配置中，显式设置 'deploy' => 1，此项为读写分离总开关，缺失则整个机制不触发。

立即学习“PHP免费学习笔记（深入）”；

3、设置 'rw_separate' => true，仅当 deploy === 1 时此参数才生效。

4、配置 'write' 为单维数组（仅允许一个主库），例如：['host' => 'master.example.com', 'username' => 'root', ...]。

5、配置 'read' 为二维数组（支持多个从库），例如：[['host' => 'slave1.example.com'], ['host' => 'slave2.example.com']]；若写成一维将静默失败。

二、ThinkPHP 5.0–5.1 显式启用 read_master 控制

该版本依赖简单逻辑判断：仅当非事务中且上一条非写操作时，select 类查询才尝试走从库，必须手动开启开关且注意上下文影响。

1、在数据库配置数组中，添加键值对 'read_master' => true，不可仅靠环境变量覆盖。

2、配置 'slave' 为单个关联数组（不支持嵌套数组），例如：['host' => '192.168.1.10', 'username' => 'ro_user']。

3、确认未处于事务中，因 inTransaction() 为真时所有查询强制回主库。

4、检查上一条执行的SQL是否为 INSERT/UPDATE/DELETE，若是，后续 find() 或 select() 将跳过从库。

三、ThinkPHP 3.2–5.x 兼容型 DB_DEPLOY_TYPE 配置

适用于旧项目平滑迁移，采用全局常量驱动，通过逗号分隔多主机地址，由框架自动按序轮询，无需修改业务代码。

1、在配置文件中设置 'DB_DEPLOY_TYPE' => 1，启用分布式部署支持。

2、设置 'DB_RW_SEPARATE' => true，开启智能读写分离。

3、将主从服务器IP以英文逗号拼接赋值给 'DB_HOST'，例如：'192.168.0.1,192.168.0.2'，首个视为主库。

4、对应填写 'DB_USER' 和 'DB_PWD'，支持简写（如 'user1,user2'）或重复值（如 'user1,user1'）。

5、若需固定读某从库，设置 'DB_SLAVE_NO' => 1（从0开始计数）。

四、手动指定连接实现细粒度控制

当默认路由无法满足特定表或场景需求（如报表库隔离），可通过显式连接绕过自动路由，直接绑定指定库实例。

1、在 config/database.php 的 connections 下新增独立从库配置，例如键名为 'mysql_report'。

2、在业务逻辑中调用 Db::connect('mysql_report') 获取该连接实例，后续所有操作均固定使用此库。

3、对模型操作，可在初始化方法中动态重设连接配置：Db::$connection->config(['read' => [...]])。

4、执行纯读查询时，务必追加 ->useReadConnection()，否则默认仍走主库。

五、原生SQL与特殊查询的主库强制策略

部分SQL语义隐含数据一致性要求，框架会主动规避从库，需明确知晓哪些情形将导致路由失效并接受主库响应。

1、查询中包含 FOR UPDATE 或 LOCK IN SHARE MODE 时，无论是否启用读写分离，均强制走主库。

2、事务块内所有查询（包括无锁 SELECT）全部路由至主库，防止主从延迟引发一致性断裂。

3、调用 Db::query() 执行原生SQL时，若语句以 SELECT 开头但含锁提示，仍被识别为主库请求。

4、模型方法中显式调用 ->master(true) 或 ->slave(false) 可覆盖默认路由规则。