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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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.authini 设置，或改用Redis实例逐个连接再合并 - ACL 用户至少要有
on,~*,@all权限（或精细控制到@cluster,@read,@write），否则CLUSTER SLOTS等元数据命令会被拒
真正麻烦的从来不是装包，而是让每个 PHP 请求都精准命中正确的 slot、在节点漂移后不丢请求、密码和权限不出错——这些细节没兜住，再“高效”的封装也只是纸老虎。
