laravel 10.x 不支持 phpredis 原生主从自动路由，需手动创建主从 redis 实例并分离读写操作；replicaof 是服务端配置，laravel 的 redis 配置不生效，且无内置故障转移与连接池。
直接说结论：Laravel 10.x 本身不支持 phpredis 的原生主从自动路由，必须手动配置连接池 + 自定义读写分离逻辑，否则 phpredis 的 replicaof 配置在 Laravel 中完全无效。
为什么 config/database.php 里的 redis 配置不生效
Laravel 的 redis 配置节（如 config/database.php 中的 'redis'）只控制 Laravel 自带的 Predis\Client 或 PhpRedis 实例的**初始化参数**，比如 host、port、password。但它不会把 replicaof 这类服务端复制指令下发给 phpredis 扩展 —— 因为那属于 Redis 服务端配置，不是客户端连接参数。
-
replicaof必须写在 Redis 从节点的redis.conf里，或运行时用SLAVEOF命令设置，和 Laravel 完全无关 - Laravel 中所有
Redis::get()、Cache::get()调用，最终都走同一个PhpRedis连接实例（默认是default连接），它只连一个地址 - 即使你启用了多个 Redis 连接（如
'cache'和'session'），它们仍是独立连接，Laravel 不会自动在它们之间做读写分发
真正能用 phpredis 主从的唯一方式：手动管理连接实例
你需要绕过 Laravel 默认的单连接封装，自己 new 出多个 Redis 实例，并按需调用：
- 写操作固定用主节点实例：
$master->set('key', 'val') - 读操作尽量用从节点实例：
$slave->get('key') - 不能依赖
Redis::Facade，它背后只有一个连接
示例代码片段（放在 Service 或 Repository 中）：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
// 手动创建主从连接
$master = new \Redis();
$master->connect('192.168.1.10', 6379);
$slave = new \Redis();
$slave->connect('192.168.1.11', 6379);
// 写走 master
$master->set('user:1001', json_encode(['name' => 'Alice']));
// 读走 slave（注意：slave 默认只读，写会报错）
$value = $slave->get('user:1001');
⚠️ 注意：$slave 连接的是已正确配置为从节点的 Redis 实例（即其 redis.conf 含 replicaof 192.168.1.10 6379），不是随便连个 IP 就能“变从库”。
容易踩的坑：延迟、只读限制与故障转移
即使主从链路通了，Laravel 层仍面临三个硬约束：
-
slave-read-only yes是默认开启的，尝试对从节点执行set会直接抛出READONLY You can't write against a read only replica.错误 -
主从复制是异步的，
$master->set()后立刻$slave->get()可能拿不到最新值，尤其在网络抖动或大 key 场景下延迟可达数百毫秒 - 主节点宕机后，从节点不会自动升级；Laravel 也不会自动把后续写请求切到新主节点 —— 这需要你自己监听哨兵事件或实现故障检测逻辑
所以，如果你真要上主从，别只配 Redis，得同步在 Laravel 里补一套连接健康检查 + 故障切换 + 读写标记机制，否则线上一挂，缓存层就全乱套。
最常被忽略的一点：phpredis 扩展本身不提供连接池或自动重试，所有连接异常（如从节点临时断连）都需要你在 PHP 层显式捕获并降级处理，否则一次 get 失败就可能让整个接口报 500。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
