切换Redis Python客户端需同步更新依赖和初始化代码，仅安装新包不生效；redis-py不支持集群，redis-py-cluster已停更，应改用redis-py 4.0+的RedisCluster；异步场景下aioredis v1与v2接口不兼容。
Redis Python 客户端怎么换 redis-py 和 redis-py-cluster
想切客户端，本质是换依赖和初始化方式，不是改配置就能生效。最常见错误是只 pip install 新包，但没动代码里的 Redis 或 RedisCluster 实例创建逻辑。
场景很明确：单节点 Redis 换成集群，或反过来；或者从 redis-py 切到更轻量的 redis-py-async（即 aioredis v2+）。
-
redis-py（redis包）只支持单节点或哨兵，不识别cluster nodes命令，连集群会直接报MOVED或ASK错误 -
redis-py-cluster已停止维护，新项目应优先用redis-py自带的RedisCluster（v4.0+），它和单节点Redis类接口相似但不能混用 - 异步场景下，
aioredisv1 和 v2 接口不兼容：v1 用from aioredis import create_redis，v2+ 改用redis.Redis.from_url(..., decode_responses=True)并加await
ConnectionError: Error 111 connecting to localhost:6379 是客户端问题还是服务问题？
这个错误本身不指向客户端类型，但切换客户端时容易误判。关键看堆栈里有没有 redis.connection 相关路径 —— 如果有，说明连接已走到底层，问题在服务端或网络；如果只有 import 或初始化失败，才是客户端没装对或版本冲突。
- 运行
pip show redis确认装的是redis还是redis-py-cluster，二者不能共存，否则import redis可能导入错模块 - 检查
sys.path是否包含旧版本安装路径（比如用 conda 装过又 pip 覆盖），导致 import 的其实是缓存的旧模块 - 集群模式下必须显式传
startup_nodes=[{"host": "x", "port": 6379}]，不能只写host/port参数，否则仍走单节点连接逻辑
Java 里 Lettuce 和 Jedis 能不能 runtime 切换？
不能。它们是完全独立的客户端实现，连接池、命令封装、异常类都不互通。所谓“切换”，实际是重构代码，把所有 Jedis 实例、JedisPool 配置、jedis.get() 调用全换成 Lettuce 的 RedisClient、GenericObjectPool 和 sync().get()。
-
Jedis是阻塞式、线程不安全，每个线程需自己getResource()；Lettuce默认共享连接，线程安全，但要小心StatefulRedisConnection的生命周期管理 - Spring Boot 2.0+ 默认用
Lettuce，如果项目还用着spring-boot-starter-data-redis但手动 new Jedis，会触发连接池冲突，日志里出现Cannot cast to RedisConnection - SSL、Unix domain socket、RESP3 协议支持差异大：
Lettuce对 RESP3 和 client-side caching 支持更好；Jedis在纯同步简单场景下内存开销略低
Go 用 github.com/go-redis/redis/v9 为什么老连不上 Redis 7？
因为 v9 默认启用 RESP3，而某些 Redis 7 部署没开 io-threads-do-reads yes 或没配 resp3 yes，导致握手失败。这不是客户端“切错了”，而是协议协商卡住。
- 启动时加
.SetResp3(false)强制降级到 RESP2：redis.NewClient(&redis.Options{Addr: "...", Protocol: 2}) - 检查 Redis 服务端配置：运行
redis-cli CONFIG GET resp3，返回resp3no就得改配置或升级客户端容忍度 - v8 升 v9 必须改代码：
ctx参数变成必填，Get(key)→Get(ctx, key)，漏传context.Background()会 panic
redis.ConnectionError 和 redis.exceptions.ClusterDownError 要分开 catch，漏一个就让熔断失效。 
