ThinkPHP数据库配置详解：主从数据库配置与读写分离实操方法

ThinkPHP读写分离失效主因是database.php中'deploy'=>1与'rw_separate'=>true两个开关未正确配置或结构不匹配；需确保二者类型准确、删除旧式单值配置，并按TP6结构化定义master/slave数组。

在ThinkPHP项目中让读操作自动分发到从库、写操作定向主库，但配置后查询仍全部打向主库，说明关键开关未启用或配置结构不匹配——这通常不是代码逻辑问题，而是database.php里一个键名拼错或数组嵌套少了一层就导致整个机制静默失效。

TP6标准配置：启用开关+结构化主从数组

这一步操作起来很简单，直接在config/database.php的connections.mysql块内补全两个布尔开关即可，但漏掉任一都会让read/write配置完全不生效。

第一步：打开config/database.php，定位到connections['mysql']配置块（若使用其他连接名，如'pgsql'，请替换为对应键名）。

第二步：确认该块内存在且仅存在以下两行：【'deploy' => 1】 和 【'rw_separate' => true】。注意'deploy'必须是整数1，不能写成true或字符串"1"；'rw_separate'必须是布尔true，不能写成1或"true"。

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

第三步：删除该配置块内所有DB_HOST、DB_NAME等旧式单值配置项，它们与TP6结构化模式冲突。

第四步：定义'default'为主库完整配置（含type、hostname、database、username、password等），再添加'slave'键，其值为二维数组，每个子数组必须包含hostname、database、username、password四项——缺任何一项都会抛出InvalidArgumentException: Database config slave is invalid。

TP5兼容配置：逗号分隔地址+开关启用

适用于老项目平滑迁移，无需改业务代码，但要求所有从库连接参数高度一致。

方法一：在config.php或database.php中设置'DB_DEPLOY_TYPE' => 1和'DB_RW_SEPARATE' => true。

方法二：将主从IP用英文逗号拼接赋值给'DB_HOST'，例如'DB_HOST' => '192.168.1.10,192.168.1.11,192.168.1.12'，首个地址自动视为主库，后续轮询使用。

方法三：对应填写'DB_NAME' => 'myapp,myapp,myapp'（若库名相同可简写为'myapp'），【'DB_USER'和'DB_PWD'必须严格按顺序对齐，否则第2个从库会用第1个用户的密码去连】。

强制走主库的三种典型场景

即使配置完全正确，以下情况也会让读操作强制回主库，这是框架内置安全策略，不是bug。

Db::table('user')->lock(true)->find() → 带锁查询一律走主库，避免从库锁状态不一致。

事务中执行任何select() → 包括Db::transaction(function () { Db::table('log')->select(); })，所有语句强制路由至主库。

调用->master(true)或全局Db::master()后，后续所有查询锁定主库，直到显式调用Db::slave()或请求结束。