redis cluster本身不提供租户隔离能力，必须通过命名空间前缀+客户端路由控制实现逻辑隔离，否则存在越界操作、热key打满节点等严重风险。
多租户场景下不能直接共享 Redis Cluster 的 slot 分配
Redis Cluster 本身不提供租户隔离能力。所有 key 都通过 crc16(key) % 16384 映射到 0–16383 的 slot，集群只认 slot 不认业务归属。如果多个租户共用同一套集群，KEYS *、FLUSHDB 这类命令会越界操作，SCAN 也容易误扫其他租户数据；更严重的是，一个租户的热 key 可能打满某个节点，拖垮整个集群的 slot 所在主节点。
常见错误现象包括：
- 租户 A 删除自己的 key，却因未加前缀导致误删租户 B 的同名 key
- 运维执行
redis-cli --cluster check时发现 slot 分布不均，实际是某租户集中写入大量相似前缀 key - 监控显示某个节点 CPU 持续 95%，但
slowlog get查不到慢命令——本质是单节点承载了多个租户的聚合流量
必须强制使用命名空间前缀 + 客户端路由控制
最轻量且落地可靠的方案，是让每个租户的数据 key 带唯一前缀（如 tenant_abc:order:1001），并由客户端 SDK 或代理层保障该前缀始终参与哈希计算。Redis Cluster 本身不校验前缀，所以这一步完全依赖接入层约束。
实操建议：
- 在应用启动时校验配置项
redis.tenant-id是否非空，为空则 panic，杜绝“忘记加前缀”的低级错误 - 禁止在业务代码中拼接裸 key，统一走封装函数：
buildKey("order", "1001") → "tenant_abc:order:1001" - 若使用
redis-cluster-proxy，开启enable-cross-slot no（默认值），防止租户跨 slot 查询引发意外扩散 - 定期用
redis-cli -c -h x.x.x.x scan 0 match "tenant_*" count 1000抽样检查 key 前缀合规性
连接池与资源配额必须按租户维度切分
即使 key 前缀规范，租户间仍会竞争连接、带宽和内存。Redis Cluster 没有原生租户级限流，必须在外围拦截。比如某租户突发 5000 QPS，可能挤占其他租户的连接池 slot，导致 ERR max number of clients reached 错误蔓延。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
关键参数差异与影响：
-
connections-pool-size：proxy 中每个线程的连接池上限，应按租户最大并发预估，而非全局统配 -
maxmemory：单节点上无法按租户限制内存，需靠 key 前缀 +MEMORY USAGE定期采样，超限时触发告警而非驱逐 - 网络层面：Kubernetes 中为每个租户 Deployment 设置
resources.limits.network（需 CNI 支持），避免一个租户打满 NodePort
性能影响明显：未做配额时，单租户故障可导致集群整体 cluster_state:fail；加配额后，故障被收敛在租户边界内，但 proxy 层 CPU 上升约 8–12%（来自额外的 prefix 解析与计数）。
删除租户数据时务必避免 FLUSHALL 和 SCAN+DEL 组合
租户下线时，直接 FLUSHALL 会清空整个集群；而用 SCAN 遍历再 DEL，在大 key 场景下易触发 cluster bus 心跳超时，被其他节点误判为 fail。这是生产环境最常踩的坑。
安全删除步骤：
- 先停写：通知上游服务将该租户流量切走，确认无新 key 写入
- 分批清理：用
SCAN每次取 100 个 key，DEL后SLEEP 0.1，避免阻塞主线程 - 验证残留：执行
redis-cli -c keys "tenant_xyz:*" | wc -l（仅限低峰期临时启用，生产禁用keys） - 终极兜底：若数据量极大（>5000 万 key），改用
redis-cli --cluster reshard将该租户所有 slot 迁移到专用“回收节点”，再整节点下线
真正复杂的是租户混布后的 slot 碎片化——比如 tenant_abc 占了 1200 个 slot，分散在 4 个主节点上，迁移时需反复交互式 reshard，每次操作都要求集群状态为 ok，稍有不慎就会卡在 WAITING FOR OK 状态。这点极易被忽略，直到下线窗口超时才暴露。
