当前位置:首页 > 文章列表 > 数据库 > Redis > Redis XGROUP CREATE 怎样为 Stream 创建消费者组

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

来源:17golang原创 2026-11-20 07:34:20 0浏览 收藏

给 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删除
MySQL FORMAT_BYTES 怎样把字节数转换成可读大小MySQL FORMAT_BYTES 怎样把字节数转换成可读大小
上一篇
MySQL FORMAT_BYTES 怎样把字节数转换成可读大小
Redis XREADGROUP 怎样按消费者组读取 Stream
下一篇
Redis XREADGROUP 怎样按消费者组读取 Stream
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1137次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1121次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1299次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1237次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1089次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码