laravel读写分离需在config/database.php中为mysql连接显式配置read/write子数组,启用sticky=true防主从延迟,事务自动走主库,多从库轮询需自定义逻辑,octane环境须禁用连接粘性。

如果您在Laravel应用中面临主库高负载、从库闲置或读操作响应延迟等问题,则很可能是读写分离配置未生效或路由策略不合理。以下是实现高效读写分离与查询负载均衡的具体方法:
一、基于模型重写的自动读写分离
该方法通过在Eloquent模型中强制覆盖newQuery()行为,使所有select查询默认使用从库连接,而写操作仍走主库,无需修改业务代码。
1、在App/Models目录下创建基础模型BaseModel.php,继承Illuminate\Database\Eloquent\Model。
2、在BaseModel中重写newQuery方法,判断当前操作类型:若为select则调用DB::connection('mysql_slave')->query(),否则使用默认连接。
3、在具体业务模型(如User.php)中继承BaseModel而非直接继承Model。
4、确保config/database.php中已正确定义mysql(主库)和mysql_slave(从库)两个连接,并严格保持database、username、password三者完全一致。
二、显式连接切换的细粒度控制
适用于需对特定查询进行精确路由的场景,例如报表类慢查询必须走专用只读从库,或某次join涉及多个从库时需手动指定。
1、在控制器或服务类中,使用DB::connection('mysql_slave_1')->table('orders')->where('status', 1)->get()显式调用从库连接。
2、对跨从库联合查询,可分别获取结果后在PHP层合并,避免数据库层不支持的分布式join。
3、在事务块内禁止切换连接,所有DB::transaction()内的语句必须使用同一连接名,否则触发PDO General error: 2014。
三、读库连接池轮询负载均衡
当部署多个从库节点时,单一从库可能成为瓶颈;通过轮询调度可将读请求均匀分发至各从库,提升整体吞吐能力。
1、在config/database.php中定义多个从库连接,如mysql_slave_1、mysql_slave_2、mysql_slave_3,各自host指向不同IP。
2、在App/Providers/AppServiceProvider.php的boot方法中注册自定义读连接解析器:
3、使用静态计数器$counter = ($counter + 1) % count($slaves),每次调用返回下一个从库名称。
4、在BaseModel的newQuery中调用该解析器获取连接名,注意多实例部署时须改用Redis原子计数替代静态变量。
四、Laravel Octane环境下的连接粘性规避
Octane常驻内存模型会复用数据库连接,若未正确配置可能导致读操作被“粘住”在刚执行过写操作的连接上,破坏读写分离逻辑。
1、检查每个从库连接配置中是否显式设置'sticky' => false,不可依赖默认值。
2、在.env中为各从库连接单独定义DB_SLAVE_HOST_1、DB_SLAVE_HOST_2等变量,并在config中分别引用。
3、在每次HTTP请求生命周期开始时,调用DB::purge('mysql_slave')清除旧连接缓存。
4、严禁在Octane环境下使用DB::connection()->reconnect(),会导致连接泄漏。
五、分片集群中MongoDB的读偏好路由
针对使用laravel-mongodb扩展连接MongoDB副本集或分片集群的场景,需通过驱动级读偏好(readPreference)控制查询分发路径。
1、在config/database.php的mongodb连接配置中添加'options' => ['readPreference' => 'secondaryPreferred']。
2、在查询构造器中动态指定:DB::connection('mongodb')->collection('logs')->readPreference('nearest')->get()。
3、确保副本集成员均开启priority配置,避免所有从节点priority=0导致无法被选为读目标。
4、对强一致性要求的查询,使用'readPreference' => 'primary'强制走主节点,但需承担主库压力。











