直接说结论：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免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
