Redis Patterns and Documentation for AI Coding Agents
Comprehensive Redis design patterns, best practices, and command references for LLM coding agents.（面向大语言模型（LLM）编码智能体的Redis 综合设计模式、最佳实践与命令参考。）
重要提示
Redis 特定文档：这些文档专门针对 Redis (https://redis.io)，可能不适用于共享部分代码库的其他系统，如 Valkey、KeyDB、Dragonfly 或其他 Redis 兼容数据库。在使用这些分支或替代方案时，请验证兼容性，因为具体实现可能存在差异。
官方源码：官方 Redis 源代码可在 https://github.com/redis/redis 获取。
官方文档：有关权威的命令文档，请参阅官方文档库 https://github.com/redis/docs，其镜像站点为 https://redis.io/docs/
命令参考
官方 Redis 文档已在本地镜像：
- 命令索引：按类别组织的各种命令的自动生成索引。
- 命令文档：单个命令文件（例如
set.md、hset.md、zadd.md）。 - 完整文档：包含开发 (develop/)、集成 (integrate/)、运维 (operate/) 指南。
上游地址：https://github.com/redis/docs
核心设计模式
构建 Redis 系统的核心架构模式。
- 原子更新模式 (Atomic Update Patterns)：通过使用
WATCH/MULTI/EXEC进行乐观锁操作、使用 Lua 脚本处理复杂逻辑以及使用影子键（shadow-key）模式进行批量更新，确保数据完整性。 - 旁路缓存模式 (Cache-Aside Pattern)：用于读密集型工作负载。缓存未命中时，从数据库获取并填充缓存；写入时，显式使缓存失效或更新缓存。
- 缓存击穿/雪崩预防 (Cache Stampede Prevention)：通过锁定、概率性早期刷新或请求合并，防止多个客户端同时重新生成过期的缓存键。
- 服务端辅助的客户端缓存 (Server-Assisted Client-Side Caching)：通过在应用内存中缓存值来消除频繁访问键的网络往返。Redis 6+ 会在数据更改时自动发送失效消息。
- 跨分片一致性模式 (Cross-Shard Consistency Patterns)：当无法进行原子多键操作时，使用事务戳、版本令牌和提交标记来检测并处理跨多个 Redis 实例的“断裂写入”。
- 延迟队列模式 (Delayed Queue Pattern)：使用有序集合（Sorted Set）安排未来执行的任务，其中分值（score）是任务应当运行的 Unix 时间戳。
- Redis 分布式锁 (Distributed Locking with Redis)：使用
SET key value NX PX timeout实现分布式进程间的互斥，具备自动过期功能。 - 哈希标签协同定位模式 (Hash Tag Co-location Patterns)：使用哈希标签（hash tags）强制将相关键分配到同一个 Redis 集群槽位，从而实现跨相关数据的原子多键操作、事务和 Lua 脚本。
- 字典序有序集合模式 (Lexicographic Sorted Set Patterns)：使用具有相同分值（通常为 0）的有序集合创建类 B 树索引，支持前缀查询、范围扫描和字符串数据的复合键查找。
- 内存优化模式 (Memory Optimization Patterns)：通过利用紧凑编码（listpack, intset）、使用哈希存储小对象以及选择内存高效的数据结构来降低 Redis 内存消耗。
- 概率性数据结构 (Probabilistic Data Structures)：使用 HyperLogLog（固定 12KB）统计唯一项，使用布隆过滤器（Bloom filters）测试集合成员身份，或使用 Count-Min Sketch 估算频率——以微小的精度损失换取巨大的内存节省。
- 频率限制模式 (Rate Limiting Patterns)：使用固定窗口、滑动窗口日志、滑动窗口计数器、令牌桶或漏桶算法实现分布式速率限制。
- Redis 作为主数据库 (Redis as a Primary Database)：将 Redis 作为亚毫秒延迟和高写入吞吐量应用的权威数据存储，将磁盘视为恢复机制而非主存储层。
- Redlock 算法 (The Redlock Algorithm)：通过在 N 个独立 Redis 实例中的大多数（N/2+1）上获取锁，实现容错的分布式锁定，在节点故障时仍能保持锁的一致性。
- 可靠队列模式 (Reliable Queue Pattern)：使用
LMOVE原子地将消息转移到处理列表中，确保至少一次投递，使消费者在崩溃后能够恢复工作。 - 流消费者组模式 (Streams Consumer Group Patterns)：使用 Redis Streams 消费者组实现可靠的消息处理，涵盖故障恢复、毒丸消息处理和内存管理。
- Redis Streams 与事件溯源 (Redis Streams and Event Sourcing)：利用消费者组、消息确认和历史回放构建持久化消息队列，非常适合事件溯源和多消费者工作负载。
- 向量集与相似性搜索 (Vector Sets and Similarity Search)：利用 Redis 8 原生的向量集（基于 HNSW 的数据结构）存储向量并查找相似项，支持语义搜索、RAG、推荐和分类。
- 写后缓存/异步写模式 (Write-Behind Caching Pattern)：仅写入 Redis 并稍后异步同步到数据库，极大提高写入吞吐量，但在持久性上有所妥协。
- 全写/同步写模式 (Write-Through Caching Pattern)：同步写入 Redis 和数据库，确保缓存与数据库的一致性。
社区模式
Redis 社区为常见用例开发的模式。
- 位图模式 (Bitmap Patterns)：使用极小内存存储数百万个布尔标记，支持跨数据集的快速聚合操作。
- 地理空间模式 (Geospatial Patterns)：使用
GEOADD、GEOSEARCH等命令存储坐标并进行半径、距离或边界框查询。 - 排行榜模式 (Leaderboard Patterns)：利用有序集合构建实时排名，支持 O(log N) 的得分更新、排名查找以及高效的 Top-N 查询。
- 发布/订阅模式 (Pub/Sub Patterns)：向多个订阅者广播实时事件，适用于通知、聊天等允许丢失消息的场景。
- 会话管理模式 (Session Management Patterns)：在 Redis 中存储用户会话并设置 TTL，根据需求选择 Hash、String 或 JSON 存储。
- 向量搜索与 AI 模式 (Vector Search and AI Patterns)：利用 Redis 向量集构建语义搜索、RAG 管道和 AI 智能体基础设施，实现亚毫秒级延迟。
生产模式
来自大型科技公司的真实规模化生产模式。
- Redis 的 Linux 内核调优：配置 Linux 内核参数以防止延迟抖动、持久化失败和连接掉线。
- Pinterest：任务队列与功能分区：学习 Pinterest 的扩展模式：按用例进行功能分区，以及基于 List 的可靠队列。
- Twitter/X：深度内部构造与自定义数据结构：Twitter 对 Redis 优化的历史案例研究，其中许多创新现已内置于 Redis 核心。
- Uber：弹性模式与交错分片：研究 Uber 的弹性技术：交错分片以防止协同故障、熔断机制以及针对 1.5 亿+次/秒操作的降级模式。
给智能体的：快速参考
缓存模式选择
| 用例 | 模式 | 关键命令 |
|---|---|---|
| 读密集，允许旧数据 | 旁路缓存 (Cache-Aside) | GET, SETEX |
| 强一致性 | 全写 (Write-Through) | SET, GET |
| 高写入吞吐量 | 写后 (Write-Behind) | SET, 异步同步 |
| 热门极值 Key | 客户端缓存 (Client-Side) | CLIENT TRACKING |
队列模式选择
| 用例 | 模式 | 关键命令 |
|---|---|---|
| 简单 FIFO | 列表 (List) | LPUSH, RPOP |
| 可靠交付 | 移动 (LMOVE) | LMOVE, LREM |
| 延迟执行 | 有序集合 (Sorted Set) | ZADD, ZRANGEBYSCORE |
| 多消费者 | 流 (Streams) | XADD, XREADGROUP, XACK |
计数与分析
| 用例 | 结构 | 内存 |
|---|---|---|
| 精确唯一计数 | 集合 (Set) | O(N) |
| 近似唯一计数 | HyperLogLog | 12KB 固定 |
| 成员资格测试 | 布隆过滤器 (Bloom Filter) | 可配置 |
| 分位数统计 | T-Digest | 可配置 |
源码与文档链接
- Redis 源码: https://github.com/redis/redis
- Redis 文档: https://redis.io/docs/
- Redis 命令: https://redis.io/commands/
- Redis 客户端: https://redis.io/docs/latest/develop/clients/