ThinkPHP数据库配置详解：主从数据库配置与读写分离实操【方法】
请在ThinkPHP框架中配置读写分离时，要求deploy设为整型数值1且rw_separate为布尔值真；TP6版本采用主从数组格式，TP5版本则用逗号分隔地址。包括带锁查询、事务内读操作及手动锁定主库这三种场景会强制走主库读取操作。
ThinkPHP读写分离配置完成后，如果发现查询语句仍然全部落在主库，通常不是代码逻辑出了毛病，而是database.php中两个关键开关没有正确配置，或者数组结构没有按框架要求对齐。更具体点说，就是“deploy”这个参数必须设置为整型1，“rw_separate”必须是布尔值true，两者缺一不可，而且配置块的结构必须从旧式的单值写法切换到TP6所要求的master/sla ve数组格式。
开头先说一个核心判断：大多数读写分离“不生效”的问题，本质上都不是框架的bug，而是配置结构的“静默失效”——键名少打一个下划线，或者数组嵌套少了一层，框架不会报错，但读操作会默认回落主库。下面直接拆开讲最主流的两种配置方式，以及几种即使配置正确也会强制走主库的特殊场景。
TP6标准配置：启用开关+结构化主从数组
其实操作本身并不复杂，就是在config/database.php的connections.mysql块内补上两个布尔开关。但这两个开关属于“一个都不能少”，漏掉任何一个，整个读写分离配置都会变成一纸空文。
第一步，打开config/database.php，找到connections['mysql']这个配置块。如果你用的是其他连接名，比如'pgsql'，那就对准对应的键名来改。
第二步，确认这个块里存在且仅存在以下两行：【'deploy' => 1】 和 【'rw_separate' => true】。这里有一个很容易踩的坑：'deploy'必须是整数1，写成true或字符串"1"都不行；'rw_separate'必须是布尔true，写成1或"true"会直接失效。类型问题在这种底层配置里非常敏感。
第三步，删掉这个配置块里所有旧式的单值配置项，比如DB_HOST、DB_NAME这类写法。它们和TP6的结构化模式有冲突，混在一起会导致框架读取配置时出现混乱。
第四步，定义'default'为主库的完整配置数组，包含type、hostname、database、username、password这些基本字段。然后添加一个'sla ve'键，这个键的值必须是二维数组，每个从库子数组里必须包含hostname、database、username、password四项。少了任何一项，框架会直接抛出一个InvalidArgumentException，提示"Database config sla ve is invalid"，错误信息相当直接，不给你半点模糊空间。
TP5兼容配置：逗号分隔地址+开关启用
这套方案适用于老项目做平滑迁移，业务代码基本不用动，但有个前提：所有从库的连接参数必须高度一致，否则配置会变得很难维护。
实现方法也不复杂。首先在config.php或database.php中设置'DB_DEPLOY_TYPE' => 1和'DB_RW_SEPARATE' => true，这两个开关的作用和TP6版是一样的。
关键区别在于数据库地址的写法。需要把主库和从库的IP用英文逗号拼接成一个字符串，赋值给'DB_HOST'。例如：'DB_HOST' => '192.168.1.10,192.168.1.11,192.168.1.12'。框架会默认把第一个地址当作主库，后面的地址按顺序轮询使用。
与之对应的，'DB_NAME'、'DB_USER'和'DB_PWD'这些字段也必须按相同的顺序对齐填写。如果所有从库的库名相同，'DB_NAME'可以简写成单个值，但用户名和密码必须严格对齐，否则第二个从库会用第一个用户的密码去连接，结果可想而知——连接失败。
强制走主库的三种典型场景
即使前面的配置全部正确，有些场景下读操作也会被强制路由回主库。这不是bug，恰恰是框架内置的安全保护策略。
第一种，带锁查询。比如Db::table('user')->lock(true)->find()这样的操作，无论写得多标准，都会直接走主库。原因很简单：从库的锁状态可能和主库不一致，带锁查询放在从库上毫无意义。
第二种，事务内的读操作。只要开启了事务，比如用Db::transaction包裹的函数，里面所有的select语句都会强制路由到主库。这同样是出于一致性的考虑——事务内的数据变更在主库上还没提交，从库根本看不到。
第三种，手动锁定主库。调用->master(true)方法或者全局的Db::master()之后，后续所有的查询都会被固定到主库，直到你显式调用Db::sla ve()或者在请求结束后自动恢复。这个功能在写后立读的场景下特别实用，比如刚保存完一篇文章，立刻查询确认，显然不能等从库同步。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
