webman 使用 redis 集群需严格配置节点列表、禁用 password、强制 database=>0、使用 webman/redis 连接池，并规范 key 设计；否则连接失败或性能下降。
Webman 用 Redis 集群不是换几个配置就能提速的——配错 endpoint、漏删 password、没设 database => 0，连接直接失败；不走 RedisCluster 类、硬套单节点写法，Couldn't map cluster keyspace 报到怀疑人生。
集群模式下连不上？先查 endpoint 是不是填了「配置端点」
AWS ElastiCache 或阿里云 Redis 集群版控制台里，“配置端点”（Configuration Endpoint）是代理地址，只适用于单节点模式。集群模式必须填「节点列表」页里的所有主节点真实地址，例如：my-cluster.xxxxx.ng.0001.use1.cache.amazonaws.com:6379。
常见错误现象：Couldn't map cluster keyspace，但 redis-cli -h 能通——说明网络没问题，只是客户端根本没走 Cluster 协议。
- 检查
config/redis.php中是否用了'clusters'数组，且数组里每个元素都是完整host:port格式 - 确认删掉了
'host'、'port'、'password'这些单节点字段，它们在集群模式下会触发冲突 - 云厂商集群不支持
AUTH命令，password字段必须为空或直接删除
为什么必须设 database => 0？
Redis Cluster 协议本身不支持 SELECT 命令，任何非 0 的 database 值都会导致 Cross-slot keys 错误——因为 key 分片由 CRC16 算出 slot，而 slot 只属于一个节点，跨 db 切换在集群里无意义。
即使你手动调用 $redis->select(1)，也会被底层拒绝，报错信息可能隐晦，但根源就在这里。
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行（RCE）的高危漏洞（CVE-2025-62507），并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级，以保障生产环境的系统稳定与数据安全。
- 集群配置中强制写
'database' => 0，不能省略 - 别指望靠配置项“默认切库”，集群模式下
select()无效，所有操作都基于 key 的 slot 自动路由 - 如果业务原来依赖多 db 隔离，改用 key 前缀代替，比如
cache:user:123和cache:order:456
连接复用不能靠 pconnect() 手写，得用 webman/redis 连接池
Webman 是常驻进程模型，每个 Worker 生命周期内若手动 new RedisCluster() 并调 pconnect()，看似复用，实则极易出错：多进程间无法共享 socket、超时参数难统一、异常后连接状态不可控。
正确路径是交由 webman/redis 扩展接管：
- 装包：
composer require webman/redis - 配置
config/redis.php中的'pool'，例如'min_connections' => 2, 'max_connections' => 10，别盲目拉高 - 业务中直接调
Redis::get('key')，扩展自动识别集群模式并分发请求 - 禁用任何在
onWorkerStart里 new 实例 + 赋全局变量的做法，这是多进程安全红线
缓存键设计和过期策略，集群下更不能偷懒
集群对 key 散列敏感，相同前缀+连续 ID（如 user:1, user:2）会导致所有 key 落在同一 slot，热点集中、扩容失效。同时，固定 TTL 容易引发雪崩。
- key 必须带业务域 + 参数签名 + 版本号，例如：
user:profile:type_a:md5_{$params}:v2 - 过期时间加随机偏移：
$ttl = 3600 + random_int(0, 300)，避免整点集体失效 - 高频读场景慎用
setex存 JSON 字符串，优先用hSet拆字段，更新时只刷局部，减少序列化开销 - 敏感字段如用户 ID 不要明文拼进 key，防缓存探测；可用
sprintf('user:profile:%s', base64_encode($uid))做轻混淆
集群不是性能银弹，它把分片、重定向、故障转移的复杂度甩给了客户端。Webman 下真正能稳住集群的，不是你手写的 RedisCluster 实例，而是配置对、协议对、连接管理对、key 设计对这四件事全到位。少一个，响应速度不升反降。
