Agent Skills
返回列表
Redis 生产实践与避坑

Redis 生产实践与避坑

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/redis-store。

技能介绍

为什么需要这份 Redis 指南

线上 Redis 往往不是「能连上就行」:没 TTL 的缓存键会常驻内存,GET 再 SET 在并发下会丢更新,单机不开 maxmemory 会把宿主机拖进 swap。团队里常见误用还包括用 KEYS * 扫全库、把 Pub/Sub 当可靠队列、以及跨槽位做 MGET 却不理解 Cluster 重定向。这些问题在代码评审和事故复盘里反复出现,却缺少一份能直接对照命令与语义的备忘。

技能覆盖什么

这份 redis-store 技能按生产主题分段,把 SKILL 正文里的要点收成可检索的知识块:

  • 过期与内存:强调每条缓存键设 TTL、SET ... EX / SETEX、KEEPTTL(Redis 6+)、惰性删除与 SCAN 时仍可能看到未清理的过期键
  • 数据结构选型:滑动窗口限流用 sorted set(ZADD + ZREMRANGEBYSCORE)、大规模去重用 HyperLogLog、可靠队列用 Streams(XADD / XREAD / XACK)、对象字段用 hash 而非大 JSON 字符串
  • 原子性与锁:INCR、SETNX、WATCH/MULTI/EXEC、Lua 脚本;分布式锁模式 SET lock NX EX + 释放时校验 token
  • 持久化与高可用:RDB / AOF 取舍、appendfsync everysec、maxmemory 与 allkeys-lru / volatile-lru、Cluster 槽位与 hash tag 让关联键同槽
  • 模式与反模式:cache-aside、写穿、固定窗口限流、连接池与 pipeline;并点名「无 TTL」「当主库却无持久化」「大块 value」等常见错误

把它装进 AI 助手后,你在设计缓存键、写限流或锁、或Review Redis 配置时,可以要「按 sliding window 限流该用哪些命令」「SET 更新会不会清 TTL」这类具体问题,回答应对齐上述语义而不是泛泛而谈。

适用边界

技能侧重 命令语义、配置取舍与架构模式,不替代官方文档的版本差异表,也不包含你环境中的具体 redis.conf 调参清单。跨机房、合规审计、或需要精确 SLA 的 messaging 设计仍要以 Streams / 外部 MQ 与运维规范为准;涉及 CLUSTER 时务必使用集群感知客户端并理解 MOVED/ASK。

使用场景

  • 新功能要用 IP 做滑动窗口限流,需在评审里选定 sorted set 与清理过期成员的命令组合
  • 缓存层用 SET 更新用户信息,要确认是否会去掉原有 TTL 并改成 KEEPTTL 写法
  • 多实例抢同一资源,要设计 SETNX+EX 锁并在释放时校验 token 避免误删他人锁
  • Redis Cluster 上用户资料与会话要同槽访问,需为键设计 hash tag 并避免跨槽 MGET

适合人员

  • 负责线上缓存 SLO 的后端,要在事故复盘里核对 TTL、maxmemory 与淘汰策略是否齐全
  • 写 API 网关限流逻辑的工程师,要在固定窗口 INCR 与滑动窗口 ZSET 之间做有依据的选型
  • 维护 Redis Cluster 的 SRE,要解释 MOVED 重定向与同槽多键操作的约束给业务方
  • 从 MySQL 迁热点读到 Redis 的开发者,要避免把 Pub/Sub 当持久化队列或 omit 持久化当主库