ThinkPHP读写分离失效主因是开关未启用或配置错误：TP6需deploy=1+rw_separate=true且read为二维数组；TP5需read_master=true且避开事务；旧版用DB_DEPLOY_TYPE=1配合DB_HOST多地址；手动连接需useReadConnection()；含锁或事务查询强制走主库。
如果您在ThinkPHP应用中需要将读操作分发至从库、写操作定向主库，但配置后查询仍全部走主库，则可能是由于关键开关未启用或配置结构不匹配。以下是针对不同ThinkPHP版本的多种可行配置方法：
一、ThinkPHP 6.0+ 启用 deploy + rw_separate 模式
该模式为TP6官方推荐方式，通过部署模式控制主从路由，读写分离行为与模型操作强绑定，需确保配置层级和键名完全正确。
1、打开 config/database.php 文件，在 connections 数组内定义名为 'mysql' 的连接配置。
2、在该连接配置中，显式设置 'deploy' => 1，此项为读写分离总开关，缺失则整个机制不触发。
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) 可覆盖默认路由规则。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
