redis集群代理不能仅靠composer包自动发现节点，必须选用支持cluster协议的客户端（如predis需启用'cluster'=>'redis'、phpredis需用rediscluster类），传入全部节点地址并正确配置密码、acl及拓扑刷新机制。

Redis集群代理不能只靠Composer包自动发现节点

Composer只是PHP依赖管理工具，它本身不提供运行时的Redis集群路由、槽位计算或故障转移能力。所谓“利用Composer库封装代理逻辑”，本质是选一个支持Redis Cluster协议的PHP客户端，并在业务代码中正确初始化和使用它——不是装个包就自动负载均衡。

常见错误是以为 composer require predis/predis 或 composer require phpredis/phpredis 后，直接 new Predis\Client(['tcp://127.0.0.1:7000']) 就能连集群。实际会报错 MOVED 或 ASK，因为单点连接无法处理重定向。

• predis/predis 需显式启用集群模式：new Predis\Client(['scheme' => 'redis', 'host' => '127.0.0.1', 'port' => 7000], ['cluster' => 'redis'])，且必须传入全部6个节点地址（或至少一个能返回 CLUSTER NODES 的节点）
• phpredis 扩展要求 PHP 进程启用 redis.clusters 配置，或用 RedisCluster 类构造，例如：new RedisCluster(['127.0.0.1:7000', '127.0.0.1:7001', ...])
• 所有节点必须已通过 redis-cli --cluster create 初始化完成，且 cluster-enabled yes 生效；否则客户端连上也拿不到槽映射表

负载均衡 ≠ 随机选节点，而是按key哈希路由到对应slot

Redis Cluster 的负载均衡是服务端强制的：客户端必须根据 key 计算 CRC16 哈希，再对 16384 取模，得到目标 slot，再查本地缓存的 slots → node 映射表，把请求发给对应节点。这不是轮询或权重调度。

容易踩的坑是手动做“连接池 + 随机选取”，结果写入数据后读不到——因为 key 被发到了错误节点，触发 MOVED 重定向，而某些旧版客户端不自动跟随（尤其是没设 retry_interval 或 timeout）。

• predis 默认不自动重试 MOVED，需配置 'parameters' => ['retry_interval' => 100]
• phpredis 的 RedisCluster 构造时传 ['cluster' => 'redis'] 才启用自动重定向，漏掉这个参数等于裸连单节点
• 如果业务大量使用 HASH 结构，注意 {tag} 语法（如 user:{123}:profile）才能保证同一业务实体的所有字段落在同一个 slot

高可用代理必须自己处理节点失联与拓扑刷新

Composer 安装的客户端库不会主动监听 CLUSTER NODES 变更。当主节点宕机、Sentinel 切换或新节点加入，客户端缓存的 slots 表可能过期，导致持续 MOVED 或连接拒绝。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

生产环境必须实现拓扑刷新机制，不能依赖“重启PHP进程”这种临时方案。

• 定期调用 $client->executeRaw(['CLUSTER', 'NODES'])（predis）或 $client->cluster('NODES')（phpredis），对比本地缓存，有变更则重建连接池
• 建议设置 30–60 秒刷新间隔，避免频繁请求影响性能；首次连接失败时立即刷新，而非死等超时
• 若用连接池（如 Swoole 协程池），需确保 slots 表是进程/协程安全共享的，否则多个协程同时刷新会冲突

密码、TLS、ACL 配置必须全局一致且显式传递

Redis 6+ 支持 ACL，但 PHP 客户端对 auth 参数的处理不统一。常见现象是：集群初始化成功，但 PHP 写入时报 NOAUTH，或部分节点能连、部分拒绝。

根本原因是客户端在构建连接时，未将密码透传到每个子连接，或 ACL 用户权限未覆盖所有命令（特别是 CLUSTER 相关指令）。

• predis 需在构造时统一指定 'parameters' => ['password' => 'mypass']，不能只配第一个节点
• phpredis 的 RedisCluster 不接受密码参数，必须用 redis.session.auth ini 设置，或改用 Redis 实例逐个连接再合并
• ACL 用户至少要有 on, ~*, @all 权限（或精细控制到 @cluster, @read, @write），否则 CLUSTER SLOTS 等元数据命令会被拒

真正麻烦的从来不是装包，而是让每个 PHP 请求都精准命中正确的 slot、在节点漂移后不丢请求、密码和权限不出错——这些细节没兜住，再“高效”的封装也只是纸老虎。