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 之后的边界规划消费范围 |

这里容易把 $ 和 > 混为一谈:$ 是创建组时的初始边界;> 是后续 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

若消费进程中途崩溃,已经投递但还没确认的消息会留在 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。
-
117 收藏
-
426 收藏
-
171 收藏
-
113 收藏
-
195 收藏
-
129 收藏
-
126 收藏
-
180 收藏
-
356 收藏
-
163 收藏
-
484 收藏
-
492 收藏
-
254 收藏
-
406 收藏
-
122 收藏
-
476 收藏
-
181 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习