普通Redis客户端抛出MovedDataError是因为它不支持集群协议，无法处理MOVED重定向响应；必须改用rediscluster.RedisCluster客户端，正确配置节点列表、密码、decode_responses等参数，并注意key设计、pipeline用法及跨slot限制。
为什么普通Redis客户端会抛出MovedDataError
因为你在用单节点客户端（比如 redis.Redis）连 Redis 集群，而集群里 key 分布在不同节点上。当客户端发请求到错误节点时，该节点返回 MOVED 12345 10.0.0.5:7001 重定向响应，但普通客户端不处理这个协议，直接抛出 MovedDataError 异常。
这不是配置错、密码错或网络不通——是协议层面的不兼容。
必须换用 rediscluster.RedisCluster（不是 redis.Redis）
redis.Redis 永远不会自动跳转；只有专为集群设计的客户端才解析 MOVED/ASK 响应并维护 slot-node 映射表。
安装和初始化要点：
- 装对包：
pip install redis-py-cluster（注意不是redis主包，它不支持集群） - 初始化时传入节点列表，不指定主从，不写 password 到 URL 里（新版要求显式传参）
- 必须设
decode_responses=True才能拿到字符串而非 bytes（否则所有get()返回b"xxx"）
示例：
from rediscluster import RedisCluster
<p>startup_nodes = [
{"host": "10.0.0.1", "port": 7000},
{"host": "10.0.0.2", "port": 7001},
]
rc = RedisCluster(
startup_nodes=startup_nodes,
decode_responses=True,
password="yourpass",
socket_timeout=5,
)
rc.set("user:1001", "alice") # 自动路由到持有 slot 12345 的节点
</p>
常见踩坑点：连接失败、超时、读不到刚写的值
这些基本都不是代码逻辑问题，而是集群客户端的默认行为与你预期不符：
-
skip_full_coverage_check=True必须加——否则只要有一个节点不可达（比如某个从节点宕机），初始化就直接报错 - 写操作默认走 master，读操作也默认走 master；如果想读 slave（比如做读写分离），得显式调用
read_from_replicas=True初始化，并且确保集群启用了cluster-allow-reads-from-replicas yes - 刚
set()完立刻get()失败？检查 key 是否含大括号——user:{1001}:profile会被 hash 到 {1001} 部分，而user:1001:profile整个字符串参与 hash，结果完全不同
不能用 pipeline？可以，但得用集群专用的 StrictClusterPipeline
普通 redis.Pipeline 在集群下会崩——它把多条命令发给同一个节点，但集群中这些 key 可能分布在不同节点上。
正确做法：
- 用
rc.pipeline()获取的是集群安全的 pipeline 对象（底层是StrictClusterPipeline） - 它会按 key 自动拆分命令、并发发往对应节点，再合并结果
- 不支持跨 slot 的 multi-key 命令（如
mget传多个不同 slot 的 key），会直接抛RedisClusterException
所以别写 pipe.mget("a", "b", "c") 除非你知道它们 hash 到同一 slot（比如都带相同 tag：{user}:a, {user}:b）。
集群路由不是“透明升级”，是协议重实现。哪怕只改一行 client 初始化，也要同步检查初始化参数、key 设计、pipeline 用法和异常类型——漏掉任何一点，都会在上线后某天凌晨三点精准触发报警。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
