配置 Redis 客户端时：用连接池/多路复用、管道批处理…

适用于审查或搭建 Redis 客户端（redis-py、Jedis、Lettuce、go-redis、NRedisStack）时，消除每请求新建连接、批量提升吞吐、避免慢命令、为热键开启客户端缓存以及设置快速失败的连接/读写超时。

适用场景

解决思路

1. 不要为每次操作新建 TCP 连接：要么用连接池（redis-py `ConnectionPool`、Jedis `JedisPooled`、go-redis client）保留 N 个常驻连接按调用租借，要么用多路复用（Lettuce、NRedisStack）让所有请求共享单条连接。
2. 按并发量设置连接池大小：池被租借完时后续租借会阻塞，因此池容量要与并发度匹配；而多路复用的单连接不能承载 `BLPOP` 等阻塞命令。
3. 对 N 条互不依赖结果的命令使用管道（pipelining）一次性批量发送，把 N 次往返压缩为 1 次：`pipe = redis.pipeline()`、循环 `pipe.get(...)`、最后 `pipe.execute()`。
4. 追求性能时使用非事务管道；只有在确实需要原子性时才使用 `pipeline(transaction=True)`。
5. 不要在生产环境调用会全量扫描的命令，改用增量变体：`KEYS pattern` → `SCAN` 游标循环；`SMEMBERS large_set` → `SSCAN`；`HGETALL large_hash` → `HSCAN`；超大列表上的 `LRANGE 0 -1` → 分页（`LRANGE 0 100`）。
6. 用游标循环遍历大 keyspace：`cursor = 0`，循环 `cursor, keys = redis.scan(cursor, match="user:*", count=100)` 逐个处理 key，直到 `cursor == 0` 才 `break`。
7. 区分阻塞命令：`BLPOP`、`BRPOP`、`BLMOVE` 是有意等待数据的，队列消费者使用没问题，但必须传超时时间，且不要在（Lettuce、NRedisStack 这类）多路复用连接上执行。
8. 对读多写少的热键（配置、功能开关、每次请求都要读的 session）开启 RESP3 客户端缓存：客户端保留本地副本、服务端在写入时使其失效，从而省掉热读的往返；示例：`redis.Redis(host="localhost", port=6379, protocol=3, cache_config=redis.CacheConfig(max_size=1000))`，其中 `protocol=3`（RESP3）是必需项。
9. 显式设置超时，不要依赖各客户端宽严不一的默认值：`r = redis.Redis(host="localhost", socket_connect_timeout=2.0, socket_timeout=5.0, retry_on_timeout=True)`，其中 `socket_connect_timeout` 用于对死节点快速失败，`socket_timeout` 按预期操作耗时调整。
10. 按经验法则：连接超时设置得比读/写超时更短；对延迟敏感路径用紧凑超时 + `retry_on_timeout=True`，批处理任务用更长的超时。

适用边界 · 注意事项

• 客户端缓存不适用于写密集或数据频繁变化的工作负载——失效通知的流量会超过省下的开销。
• 不要在多路复用（Lettuce、NRedisStack）连接上执行 `BLPOP`/`BRPOP`/`BLMOVE` 等阻塞命令。
• 不要在生产环境对大型 keyspace 或大容器使用 `KEYS`、`SMEMBERS`、`HGETALL`、`LRANGE 0 -1`，它们会阻塞服务器。