Redis 与缓存 / 知识点

Redis 开发常用命令速查

可确认的流式队列

CODE
XREADGROUP GROUP group consumer [COUNT count] [MAXCOUNT maxcount] [MAXSIZE maxsize] [BLOCK milliseconds] [CLAIM min-idle-time] [NOACK] STREAMS key [key ...] id [id ...]

以组内消费者身份读取并登记待确认消息,适合可重试的后台任务;使用 > 读取新消息,处理完成后必须显式确认以避免长期积压。

按消费者组领取消息

当多个后台进程需要分担 Redis Stream 中的任务,并在失败后补处理时,使用 XREADGROUP 以组和消费者身份领取消息。默认情况下,已投递但未执行 XACK 的消息 ID 会留在待确认列表(PEL)中,可供后续检查和重试。

基本语法

bash
XREADGROUP GROUP <group> <consumer> [COUNT <count>] [BLOCK <milliseconds>] STREAMS <key> <id>

以上为常用格式示意;完整语法还支持 MAXCOUNT、MAXSIZE、CLAIM、NOACK 和多个 Stream。GROUP 所指的消费者组必须已存在,消费者名称首次出现时会自动登记。STREAMS 后先列所有键,再提供一一对应的 ID;在 Shell 中传递特殊 ID > 时,需写成 '>',避免被解释为输出重定向。

决定领取范围的选项

选项 含义与限制
STREAMS key > 领取该组尚未投递过的新消息;同组消费者分摊任务。
STREAMS key 0 只读取当前消费者自己的未确认消息,不会自动接管其他消费者的任务。
COUNT n 每个 Stream 最多返回 n 条,不保证达到上限。
BLOCK ms 没有可读的新消息时最多等待 ms 毫秒;0 表示无限等待。读取自身 PEL 时忽略此选项。
NOACK 新领取的消息不进入 PEL;处理失败可能无法恢复,不适用于可靠任务。
CLAIM ms Redis 8.4 起支持;与 > 配合时优先接管空闲达到阈值的 PEL 消息,再读取新消息。
MAXCOUNT n / MAXSIZE bytes Redis 8.10 起支持;分别限制多流合计返回条数与响应字节预算。MAXCOUNT 与 COUNT 同时使用时不能更小;MAXSIZE 允许至少返回一条超过预算的大消息。

消息、PEL 与确认关系

Stream 消费者组领取、重试与确认的数据流

领取成功不代表业务处理成功。XREADGROUP 把消息关联到消费者和 PEL;只有在任务完成后执行 XACK key group id,才会移除该组中的未确认记录,不会删除 Stream 原消息。未确认任务也不会仅因再次使用 > 就自动重新派发。

可复现的领取与确认

前提:Redis 5.0 及以上版本、可连接的本地 redis-cli,并确保测试键 demo:xreadgroup:61 尚不存在。为使输出可验证,示例使用固定消息 ID 1-0,仅用于空测试流。

bash
# 建立组并允许创建空流;起点 0 可读取随后写入的消息
redis-cli XGROUP CREATE demo:xreadgroup:61 g1 0 MKSTREAM
redis-cli XADD demo:xreadgroup:61 1-0 kind email
# Shell 中的 '>' 必须加引号;领取后先检查 PEL
redis-cli XREADGROUP GROUP g1 c1 COUNT 1 STREAMS demo:xreadgroup:61 '>'
redis-cli XPENDING demo:xreadgroup:61 g1
# 未确认前,同一消费者可通过 ID 0 重读自己的 PEL
redis-cli XREADGROUP GROUP g1 c1 COUNT 1 STREAMS demo:xreadgroup:61 0
redis-cli XACK demo:xreadgroup:61 g1 1-0
redis-cli XPENDING demo:xreadgroup:61 g1

预期结果:建组返回 OK,写入返回 1-0;两次读取都包含消息 1-0、字段 kind 和值 email。首次 XPENDING 的未确认总数为 1;XACK 返回 1;最后一次 XPENDING 的未确认总数为 0。生产环境通常使用 XADD ... * 自动生成 ID,确认时传入实际收到的 <ID>。

失败处理与边界

  • 遇到 NOGROUP:先确认流键和组名是否正确,必要时用 XGROUP CREATE 创建组。已有组重复创建会返回 BUSYGROUP,不要误以为必须重置数据。
  • 消费者重启:先用 XPENDING 查看积压,再用 STREAMS key 0 重读该消费者自己的未确认任务;其他消费者遗留的任务可用 Redis 6.2 起支持的 XAUTOCLAIM 接管,或在 Redis 8.4 起使用 CLAIM ms。
  • 发生重复执行:消息可能在业务成功后、确认前因进程退出而被再次领取。按业务任务 ID 实现幂等处理,业务提交成功后再执行 XACK;不要使用 NOACK 回避积压。

BLOCK 超时返回空结果不表示出错。各新增选项的版本适用性可核对 Redis XREADGROUP 官方文档。

事务与原子逻辑

地理与近似统计

目录与阅读设置

记录一个想法

Redis 开发常用命令速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通