PHP如何配置Eloquent读写分离 Laravel主从设置指南

Laravel 的 Eloquent 本身并不自动处理主从读写分离，真正的读写路由由底层数据库连接池根据严格的配置结构和策略（如 `sticky` 开关、`on()` 与 `forceWrite()` 的正确使用）动态决定；配置中一个括号错误、`read.host` 未写成数组、遗漏 `sticky => true` 或误用 `connection()` 替代 `on()`，都可能导致查询意外打到主库或数据延迟丢失——这不仅影响性能，更可能引发线上逻辑故障，因此必须精准嵌套配置、合理启用粘性会话，并通过抓包或 `SHOW PROCESSLIST` 等硬核手段验证实际流量走向。

直接说结论：Laravel 的 Eloquent 本身不感知主从，读写分离靠的是底层 DB 连接池的「连接选择策略」，不是模型自动路由；配置错一个键、漏掉 sticky 或没关缓存，查询就可能打到主库或报错。

主从配置必须写对 database.php 的嵌套结构

Laravel 不接受扁平化配置。常见错误是把 read 和 write 直接写在 mysql 下一级，实际必须嵌套在 connections.mysql 内部，且 read 是数组（支持多从）：

'mysql' => [
    'driver' => 'mysql',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    'read' => [
        'host' => ['192.168.1.10', '192.168.1.11'], // 多个从库 IP
    ],
    'write' => [
        'host' => '192.168.1.5', // 主库唯一
    ],
    'port' => '3306',
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    // ...其他键保持不变
],

• 如果只写 'read' => ['host' => '...']（没包成数组），Laravel 会忽略整个 read 配置，所有查询走主库
• read.host 必须是数组，哪怕只有一个从库：['192.168.1.10']，不能是字符串
• write.host 只能是字符串，不支持数组（主库不允许多个）

sticky 开关决定「事务后是否强制读主」

默认 sticky 关闭。这意味着：你刚在主库插入一条记录，紧接着用 User::find(123) 查询，Eloquent 可能从从库读——而从库还没同步完，查不到。

• 开启方式：在 connections.mysql 下加 'sticky' => true
• 开启后，只要当前请求中执行过写操作（save()、update()、DB::statement() 等），后续所有 SELECT 都强制走主库，直到请求结束
• 代价：牺牲部分从库分担能力；高并发写多读少场景可关，但一般建议开，避免数据延迟导致的逻辑 bug
• 注意：sticky 对 DB::select() 生效，但对原生 PDO 操作无效

手动指定读写连接要用 on()，不是 connection()

connection() 切换的是整个连接名（比如 mysql2），不是主从角色；真正控制读写路由的是 on() 方法，它会触发 Laravel 的连接选择器：

// ✅ 正确：强制走主库（即使当前是读操作）
User::on('mysql')->forceWrite()->find(123);

// ✅ 正确：强制走某个从库（需提前定义 connections.read_slave）
User::on('read_slave')->find(123);

// ❌ 错误：connection() 不触发读写分离逻辑，只是换连接名
User::connection('mysql')->find(123); // 仍按默认策略选主/从

• forceWrite() 是关键，它绕过读写判断，直连 write 配置的 host
• 如果要临时读特定从库，得先在 database.php 定义独立连接（如 read_slave_1），再用 on('read_slave_1')
• DB::table('users')->on('mysql')->forceWrite()->insert(...) 同样生效

验证是否真走从库？别信日志，抓包或看 MySQL processlist

DB::enableQueryLog() 在读写分离下不可靠——日志显示的 host 是连接池选中的，但你没法确认是主还是从；更糟的是，有些 IDE 插件或调试工具会触发额外查询，污染结果。

• 最准方法：登录从库服务器，执行 SHOW PROCESSLIST;，看是否有你的应用 IP 的 SELECT 连接
• 或者用 tcpdump -i any port 3306 -A | grep -i 'select.*users' 抓包比对目标 IP
• 在 AppServiceProvider@boot 中加监听，打印每次连接的 host：

DB::connection('mysql')->getPdo(); // 触发连接建立
$host = DB::connection('mysql')->getConfig('read.host')[0] ?? 'unknown';
// 实际 host 需通过 $connection->getPdo()->getAttribute(PDO::ATTR_CONNECTION_STATUS) 间接推断，但较麻烦，不如抓包直接

配置里少一个方括号、sticky 没设、或是用了 DB::transaction() 但没配 sticky，都可能导致读请求意外打到主库——这种问题线上很难复现，必须在压测阶段用真实流量验证。

终于介绍完啦！小伙伴们，这篇关于《PHP如何配置Eloquent读写分离 Laravel主从设置指南》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！