登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  Redis

Redis XGROUP CREATE 怎样为 Stream 创建消费者组

来源:17golang原创

时间:2026-11-20 07:34:20 142浏览 收藏

给 Redis Stream 配置消费者组时,真正要先做的决定不是组名,而是“这个组从哪条消息开始接收”。如果要补处理已有消息,使用 0;如果只关心创建组之后的新消息,使用 $。最小命令是:

# 从 Stream 的已有消息范围开始建立消费者组
XGROUP CREATE orders:events order-workers 0

# 只让新消息进入这个组的消费范围
XGROUP CREATE orders:events realtime-workers $

官方地址:https://redis.io/docs/latest/commands/xgroup-create/

要点速览
  • 0 适合首次接管历史消息,$ 适合从创建时的末尾开始追新消息。
  • 默认情况下目标 Stream 必须已经存在;初始化流程可以追加 MKSTREAM 创建空 Stream。
  • 命令返回 OK 只代表组创建成功,真正消费还要用 XREADGROUP,处理完成后用 XACK。

先决定消费者组从哪条消息开始

XGROUP CREATE 的第三个参数是组的初始读取位置。它不会把消息复制到另一个队列,而是为这个组记录一个“最后投递到哪里”的起点。

起始 ID适用场景创建后的效果
0新服务需要补消费历史事件后续可从已有消息开始读取
$只处理组建立之后的新事件已存在的消息不进入首次新消息读取
具体 Stream ID从某个已知位置切入按该 ID 之后的边界规划消费范围
Redis Stream XGROUP CREATE 中 0 与 $ 两种消费者组初始游标的结构说明图
图1:Redis Stream 消费者组起始游标说明图,0 表示从已有消息范围开始,$ 表示从创建时的末尾开始。

这里容易把 $ 和 > 混为一谈:$ 是创建组时的初始边界;> 是后续 XREADGROUP 请求“尚未投递给任何消费者的新消息”。两者处在不同命令阶段。

用 XGROUP CREATE 创建消费者组

完整语法可以记成 XGROUP CREATE key group id,也可以在末尾加入 MKSTREAM 和可选的 ENTRIESREAD。例如,先写入一条测试事件,再创建从历史开始读取的组:

# 写入一条事件,* 让 Redis 自动生成 Stream ID
redis-cli XADD orders:events * order_id 1001 status paid

# 为已有 Stream 创建消费者组;0 让组具备读取历史的起点
redis-cli XGROUP CREATE orders:events order-workers 0

# Redis 成功时返回 OK;同一组名再次创建会返回 BUSYGROUP

创建动作本身是 O(1),返回 OK 表示 Redis 已建立组状态。它不会自动注册具体消费者,也不会自动处理消息;消费者名称是在 XREADGROUP GROUP group consumer 中提供的。

Stream 不存在时用 MKSTREAM 做初始化

默认命令要求目标 Stream 已经存在。如果生产者和消费者的启动顺序不固定,直接创建组可能收到 “ The XGROUP subcommand requires the key to exist ” 一类错误。这时把 MKSTREAM 放在 ID 后面:

MKSTREAM 创建的是长度为 0 的空 Stream,不代表已经有一条可消费消息。若业务需要“首次启动补历史”,不能只加 MKSTREAM,还要先明确历史数据从哪里来,并选择 0 或具体 ID。

创建之后怎样确认组能正常消费

先用 XINFO GROUPS 查看组,再用 XREADGROUP 读取。下面的命令把“观测”和“消费”分开,便于排查是组没建好,还是读取游标选错:

# 查看 Stream 下的消费者组、消费者数量、pending 数量和最后投递 ID
redis-cli XINFO GROUPS orders:events

# 读取这个组尚未投递给消费者的新消息;BLOCK 只等待 2 秒
redis-cli XREADGROUP GROUP order-workers worker-1 COUNT 10 BLOCK 2000 STREAMS orders:events >

# 业务处理成功后确认消息,避免它长期留在 Pending Entries List
redis-cli XACK orders:events order-workers 1700000000000-0
Redis Stream 消费者组中 XGROUP CREATE、XINFO GROUPS、XREADGROUP、XACK 与 PEL 的关系说明图
图2:Redis Stream 消费者组接口关系说明图,展示创建、读取、确认和观测之间的职责边界。

若消费进程中途崩溃,已经投递但还没确认的消息会留在 PEL。恢复程序应先按组读取待处理历史,再切回 > 读取新消息;不要把“创建成功”误当成“消息已处理完成”。

BUSYGROUP 与 NOGROUP 的处理清单

  • BUSYGROUP:同一个 Stream 下已经存在同名消费者组。启动脚本应把“已存在”当作幂等结果,先用 XINFO GROUPS 检查,而不是反复创建。
  • 目标 Stream 不存在:需要初始化空 Stream 时加 MKSTREAM;如果必须消费历史,则先解决历史来源。
  • NOGROUP:通常出现在读取阶段的组名或 Stream key 不匹配。核对 GROUP 后的组名、STREAMS 后的 key,以及创建命令是否在同一 Redis 实例执行。
  • 重复收到消息:检查是否在业务成功后执行了 XACK,并区分新消息读取和 PEL 恢复读取。

相关问题

XGROUP CREATE 的 0 和 $ 应该怎么选?

需要补消费已有事件时选 0;只接收创建之后的新事件时选 $。这是组的初始边界,不能靠后续消费者名称补救。

加了 MKSTREAM 后为什么还是读不到消息?

MKSTREAM 只创建空 Stream,不生产消息。必须先用生产者执行 XADD,再让消费者用 XREADGROUP 读取。

创建消费者组后能直接用 XREAD 读取吗?

可以用普通 XREAD 读取 Stream,但它不使用消费者组的投递与确认状态。需要组内分摊、PEL 和 XACK 时,应使用 XREADGROUP。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>