Redis XGROUP CREATE 怎样为 Stream 创建消费者组
给 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。
MySQL FORMAT_BYTES 怎样把字节数转换成可读大小
- 上一篇
- MySQL FORMAT_BYTES 怎样把字节数转换成可读大小
- 下一篇
- Redis XREADGROUP 怎样按消费者组读取 Stream
-
- 数据库 · Redis | 10小时前 |
- Redis ECHO 怎样原样返回消息而不写入键
- 129浏览 收藏
-
- 数据库 · Redis | 20小时前 | 性能排查 · redis redis-cli LATENCY GRAPH latency monitor 延迟排障
- Redis LATENCY GRAPH 怎样把事件延迟画成可读趋势
- 180浏览 收藏
-
- 数据库 · Redis | 20小时前 | redis 分数 有序集合 WITHSCORES ZRANDMEMBER 随机成员
- Redis ZRANDMEMBER WITHSCORES 怎样同时读取随机成员分数
- 254浏览 收藏
-
- 数据库 · Redis | 20小时前 | Sorted Set · redis limit 有序集合 BYSCORE ZRANGESTORE BYLEX
- Redis ZRANGESTORE LIMIT 怎样只保存范围中的部分成员
- 122浏览 收藏
-
- 数据库 · Redis | 20小时前 | Redis · 统计 · redis INFO commandstats
- Redis INFO commandstats 怎样查看命令调用统计
- 476浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1137次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1121次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1299次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1237次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1089次使用
-
- Go与Redis实现分布式互斥锁和红锁
- 2022-12-22 117浏览
-
- Go+Redis实现延迟队列实操
- 2023-02-23 426浏览
-
- 一文搞懂Go语言操作Redis的方法
- 2023-01-07 171浏览
-
- Golang分布式应用之Redis示例详解
- 2023-01-07 113浏览
-
- Go Redis客户端使用的两种对比
- 2022-12-30 195浏览

