redis集群中事务失败的根本原因是涉及的key未落在同一slot，必须用hash tag（如{user:1001}:name）强制对齐，否则触发crossslot错误；所有多key命令均受此限制，且事务原子性仅限单节点内有效。
Redis集群中事务（MULTI/EXEC）失败，根本不是事务本身有问题，而是所有涉及的key没落在同一个slot——必须用Hash Tag强制对齐，否则直接报CROSSSLOT错误。
为什么MULTI在集群里一执行就报错
集群不支持跨slot事务。哪怕你只写两个key：user:1001:name 和 user:1001:email，只要它们哈希后落到不同slot，EXEC就会触发redis.exceptions.ResponseError: CROSSSLOT Keys in request don't hash to the same slot。这不是客户端bug，是集群设计硬限制：事务原子性只在单节点内有效。
常见误判点：
- 以为加了
WATCH就能跨节点监听——不行，WATCH也受slot约束 - 以为客户端自动重试或拆分命令能兜底——Lettuce/Jedis等主流客户端遇到
CROSSSLOT直接抛异常，不会降级 - 用
redis-cli -c连集群时手敲MULTI成功，换成代码就失败——因为CLI可能碰巧连对了节点，而代码走的是自动路由逻辑
{}不是随便加花括号，得精准控制哈希子串
Redis集群默认用{}作为Hash Tag边界，但只对花括号内内容做CRC16计算。关键不是“加{}”，而是“加在哪、包什么”。
正确做法：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 把业务强关联字段放进
{}，比如用户ID：{user:1001}:name和{user:1001}:email→ 都哈希user:1001，必然同slot - 避免用固定字符串，比如
{common}:cfg→ 所有配置全挤进一个slot，引发数据倾斜 - 别嵌套或跨段落用
{}，如order:{202405}:{1001}→ 只取第一个{}内的202405哈希，1001被忽略 - 确认服务端hash_tag配置，有些老集群配的是
$$而非{}，得查redis.conf里的hash_tag项
批量操作（MGET/MSET）也得过同一关
事务只是冰山一角，所有多key命令都受slot限制：MGET、MSET、DEL、EVAL脚本里访问多个key……只要不在同slot，一律CROSSSLOT。
实操建议：
- 用
redis-cli -c cluster nodes确认当前slot分布，再用python -c "import redis; print(redis.cluster.key_slot('{user:1001}:name'))"（或手算crc16('user:1001') % 16384）验证tag是否生效 - 上线前必须抽样检查：用
cluster getkeysinslot {slot} 100拉出一批key，确认它们确实共享同一业务维度（比如全是{user:1001}*） - 别依赖
redis-cli --bigkeys查问题——它只报大key，不暴露tag导致的slot集中 - 已上线的热key改tag时，禁止直接rename，必须双写过渡：新逻辑写
{user:1001 % 100}:profile，读逻辑先查新key，未命中再查旧key
Hash Tag改完还不行？检查客户端和集群状态同步
即使key命名完全合规，仍可能因客户端缓存过期拓扑或集群正在reshard而路由错位。这时MOVED或ASK错误会掩盖真实的CROSSSLOT问题。
排查顺序：
- 先用
redis-cli -c -h {host} -p {port}连集群，手动执行MGET {user:1001}:name {user:1001}:email，看是否报错——排除客户端SDK干扰 - 检查
redis-cli -c cluster info输出中的cluster_state:ok和cluster_slots_assigned:16384是否正常 - 确认客户端是否开启拓扑自动刷新（如Lettuce的
DynamicNodeResolver），禁用后强制重启连接再试 - 留意集群是否在执行
CLUSTER SETSLOT ... MIGRATING——迁移中slot的key可能被临时拒绝访问
最易被忽略的一点：Hash Tag只解决key分配问题，不解决主从延迟。如果事务里先SET再GET，且读到了从节点，仍可能拿到旧值——这和slot无关，得靠读写分离策略或强制读主节点来兜底。
