Composer 客户端不支持 Redis 主从读写分离，所谓分离实为私有仓库后端服务（如 Satis）引入 Redis 缓存层并按读/写路径路由：写操作打主节点，读操作路由从节点，需用 Predis 等支持复制拓扑的客户端正确配置角色与超时。
Composer 本身不支持 Redis 主从集群的读写分离，composer install 或 composer update 的元数据查询逻辑完全走 HTTP（Packagist 或私有 Satis/Sleet 服务），和 Redis 无直接关系。所谓“利用 Redis 主从集群实现私有源高频查询读写分离”，本质是**在私有 Composer 仓库后端服务中引入 Redis 缓存层，并对其读写流量做分离**，而非 Composer 客户端行为。
私有源后端如何接入 Redis 主从集群
私有源（如 Satis、Private Packagist、自研 PHP 仓库服务）通常用 PHP + MySQL/MariaDB 存储包元数据。高频访问下瓶颈常在数据库读压力。此时可将 packages.json、dist URL、metadata 等只读响应缓存到 Redis —— 但必须区分读/写路径：
- 写操作（如触发 rebuild、新增包、Webhook 回调）只打向主节点：
redis-cli -h master-ip -p 6379 -a password SET packages:foo/bar '{"name":"foo/bar",...}' - 读操作（如
/packages.json响应、/p2/xxx.json查询）全部路由到从节点，例如用Predis\Client配置多个read_write_timeout和replication模式 - PHP 代码中不能硬编码单个 Redis 实例，需使用支持复制拓扑的客户端，如
Predis的ReplicatedConnection或phpredis的RedisCluster（注意：后者不等同于 Redis Cluster，而是客户端侧的主从路由）
为什么 Predis::create() 的 replication 配置容易失效
常见错误是以为配置了 'replication' => true 就自动读从写主，实际必须显式指定角色：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
'replication' => 'sentinel'或'replication' => 'shared'才生效；纯true会被忽略 - 从节点列表必须包含
'role' => 'slave'键，否则客户端默认全当 master 用 - 主节点必须标记
'role' => 'master'，且仅一个；多个 master 会导致写冲突 - 连接池未设置
'read_timeout'时，从节点网络抖动会阻塞整个请求，建议设为0.1秒级
SpringBoot + RedisTemplate 不适用于 Composer 私有源
这是典型的技术栈错配。RedisTemplate 是 Spring 生态对 Redis 的 Java 封装，而 Composer 私有源几乎全是 PHP 实现（Satis、Toran Proxy、自研 Laravel/Symfony 服务）。强行混用会导致：
- Java 服务暴露 HTTP 接口给 Composer 客户端，但 Composer 不识别 Java 的序列化格式或响应头
- RedisTemplate 默认使用
JdkSerializationRedisSerializer，PHP 客户端无法反序列化byte[]数据 - 若改用
StringRedisTemplate，仍需在 PHP 层额外开发 JSON ↔ String 的双向适配逻辑，得不偿失 - 真正该复用的是 Redis 协议本身，不是某语言的 SDK
从节点返回 stale 数据的根源与规避
Redis 主从复制是异步的，slave-serve-stale-data yes 是默认值，意味着从节点即使断开主节点也会继续响应旧数据。这对私有源极危险——用户可能拉到过期的 dist URL 或已删除包的 metadata：
- 必须在从节点配置中设
slave-serve-stale-data no，断连时直接返回错误，避免静默脏读 - PHP 服务读取前加一层健康检查：
INFO replication中master_link_status:up且master_sync_in_progress:0 - 关键元数据（如
packages.json的packages数组）建议加版本号字段，PHP 层对比cache_version再决定是否穿透回 MySQL - 不要依赖
REPLICAOF命令动态切换从节点角色；Docker Compose 启动时就固定好主从拓扑
真正要落地读写分离，核心不在工具链包装，而在明确哪条请求路径必须走主、哪条允许走从，以及如何让 PHP 服务感知从节点状态。绕过这点谈“一键分离”，最后只会缓存一堆过期 dist 链接。
