Redis 连接实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/redis-agent-skills-redis-connections。
技能介绍
要解决什么问题
生产环境里 Redis 延迟往往不来自单次 GET,而是客户端为每个请求新建 TCP 连接、成百上千次往返,或误用 KEYS、HGETALL 把整库扫描拖在单线程事件循环上。迭代大 key、队列消费与热读路径如果没有统一约定,排查只会停留在「Redis 很慢」而看不见调用侧。
技能如何工作
本技能按客户端生命周期给可执行清单:
- 连接模型:在 redis-py / Jedis / go-redis 用 Pool,在 Lettuce / NRedisStack 用 Multiplex;禁止「一请求一连接」。
- 批量提交:无依赖的多条命令用 pipelining 合并往返;仅在需要原子性时用
pipeline(transaction=True)。 - 避免全量遍历:
KEYS→SCAN游标循环;大 set/hash/list 用SSCAN/HSCAN/ 分页LRANGE。 - 热键缓存:读多写少的配置、开关、会话可开 RESP3 client-side caching;写密集场景慎用。
- 超时策略:显式区分 connect 与 read/write;敏感路径短超时加重试,批处理可放宽。
阻塞命令(BLPOP 等)需带 timeout,且不要挂在多路复用连接上。
适用边界
它不替你做服务端内存淘汰、集群分片或事务语义设计;也不覆盖 write-heavy 数据上的本地缓存收益评估。适合在 新建或 Code Review 客户端配置 时对照引用文档(pooling、pipelining、blocking、client-cache、timeouts)。
使用场景
- 用 redis-py 写新服务时,要把每请求新建连接改成 ConnectionPool 并估算并发池大小
- 接口里连续数十次 Redis 调用延迟偏高,需要用 pipelining 合并无关命令的往返
- 运维脚本曾用 KEYS 扫前缀,要改成 SCAN 游标循环避免阻塞线上实例
- 会话或功能开关每次请求都读 Redis,要评估是否启用 RESP3 客户端侧缓存
适合人员
- 维护 Java Jedis 连接池的后端工程师,需要在 Code Review 里拦截 BLPOP 与池化误用
- 负责 go-redis 网关层的 SRE,要统一 connect/read 超时与失败快速熔断策略
- 用 Lettuce 做多服务共享连接的架构师,要确认阻塞命令不能走在多路复用连接上
- 排查「Redis P99 抖动」的性能工程师,要区分是全量 HGETALL 还是缺少 pipeline 批量