必须先在database.php的connections中预定义所有数据库连接，包括type等六项完整参数；启用读写分离需同时配置deploy=1、rw_separate=true、write为一维数组、read为二维数组，并统一charset；读操作须显式调用usereadconnection()或db::connect()指定只读连接，事务中强制走主库。
要在ThinkPHP中让业务数据走主库、日志查询走独立从库、报表统计再连另一套只读集群，必须先在database.php里把每个库的连接名和完整参数预定义清楚，临时拼接配置或漏写type字段会导致连接失败甚至中文乱码。
预定义多个数据库连接
这一步是所有多库操作的前提，Db::connect('log_db')能生效，只因它在connections数组里有对应键名和完整配置。
打开config/database.php文件，定位到return数组中的'connections' => []部分。
在connections数组内新增一个名为'log_db'的连接配置，内容必须包含'type'、'hostname'、'database'、'username'、'password'、'charset'六项，缺一不可；漏掉'type' => 'mysql'会导致框架用默认驱动解析PostgreSQL配置，报错Class 'PDO' not found。
复制粘贴配置后务必逐项核对hostname和port，常见错误是两个连接都指向192.168.1.10，结果日志写入和业务数据混在同一实例上。
连接名严禁含点号（如'log.db'）或大写字母，Db::connect('log.db')会直接抛出Connection not found异常。
启用读写分离机制
读写分离不是自动识别SQL语义，而是靠deploy开关+rw_separate规则+显式方法调用三者共同触发。
第一步：在connections['mysql']配置块中添加'deploy' => 1，这是总开关，缺失则read/write配置完全被忽略。
第二步：设置'rw_separate' => true，仅当deploy === 1时该参数才生效。
第三步：配置'write'为单维数组，例如['hostname' => '192.168.1.10']；若误写成二维数组，TP启动即报Invalid write database config。
第四步：配置'read'为二维数组，例如[['hostname' => '192.168.1.11'], ['hostname' => '192.168.1.12']]；若写成一维['192.168.1.11', '192.168.1.12']，框架静默失败，所有读操作回退主库。
第五步：确保主库与所有从库的'charset'值完全一致，比如都设为'utf8mb4'；若主库用utf8mb4而某个从库是utf8，emoji字段写入会失败或显示为问号。
手动切换读库执行查询
TP6不自动判断SELECT是否该走从库，必须主动声明“这是读操作”，否则Db::table('user')->select()默认仍连主库。
方法一：链式调用useReadConnection()
Db::table('user')->useReadConnection()->select() → 从read数组中轮询选取一台从库执行。
方法二：使用Db::connect()指定只读连接名
Db::connect('mysql_read')->table('user')->select() → 此处'mysql_read'需在connections中预定义为独立只读连接，与主从分离配置无关。
【注意】事务中调用useReadConnection()无效，所有查询强制走主库，这是框架内置安全策略，无法绕过。
方法三：模型层全局指定读库
在UserModel类中重写getConnectionName()方法，返回'mysql_read'，此后该模型所有操作默认走此连接，但with()关联查询仍需单独设置。
验证读写分离是否生效
在控制器中插入调试代码：
echo Db::table('user')->useReadConnection()->getLastSql();
查看输出的SQL是否带主机IP信息，或直接在MySQL从库的general_log中搜索该SQL，确认是否真实执行于从库节点。
执行写操作：
Db::table('user')->insert(['name' => 'test']);
此时观察是否命中write配置中的hostname，而非read列表里的任意地址。
在事务中执行读操作：
Db::transaction(function () {
Db::table('user')->useReadConnection()->find(1);
});
该find()必定走主库，若日志显示从库执行，则说明配置未生效或框架版本不匹配。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
