Redis 与缓存 / 系统课时
创建 Consumer Group
创建 Consumer Group
本课解决 Redis Streams 消费组的初始化问题:创建 group,理解它记录的投递起点,并根据是否需要回放历史消息正确选择 0 或 $。完成后,你还能用 XINFO GROUPS 验证创建结果。
学习目标
- 能使用
XGROUP CREATE创建消费组并指定初始位置 - 能区分 Stream、consumer group 和 consumer 的职责
- 能根据是否回放历史消息选择
0或$
理解 Stream、Group 与 Consumer
Stream 是按 Entry ID 排序保存消息的日志;consumer group 建立在某个 Stream 上,维护该组自己的投递位置和待确认消息;consumer 则是组内具体的消费身份,例如 worker-a。创建 group 不会自动创建 consumer,consumer 通常在客户端第一次以该名称读取时出现,也可以显式创建。
同一个 Stream 可以存在多个彼此独立的 group,每个 group 都维护自己的 last-delivered-id。因此,“从哪里开始投递”是 group 的状态,不是 Stream 的全局游标,也不是某个 consumer 单独保存的位置。

创建消费组并设置起点
XGROUP CREATE key group <id | $> 中的 id 用来设置新 group 的初始 last-delivered-id。特殊值 $ 表示创建 group 时 Stream 中最后一条 Entry 的 ID;它不是固定值,也不是 XGROUP CREATE 返回的 ID。
下面先写入两条消息,再以 $ 创建消费组。建议只在独立测试环境使用未占用的 key 和 group 名称执行。
redis-cli XADD orders:group-demo '*' order_id 1001 status CREATED
redis-cli XADD orders:group-demo '*' order_id 1002 status PAID
redis-cli XGROUP CREATE orders:group-demo order-workers '$'预期输出:
<ID>
<ID>
OK前两行 <ID> 是两次 XADD 实际生成的 Entry ID,执行时间不同,值也不同;第三条命令只返回 OK。因为创建时使用 $,此时 group 的 last-delivered-id 应等于第二次 XADD 返回的实际 ID,而不是某个固定示例值。
如果目标 Stream 可能尚不存在,可以在创建命令末尾加 MKSTREAM。它只负责在 key 不存在时先创建空 Stream,不会改变 0 与 $ 的起点语义。
选择 0 与 $
选择起点前先判断:新 group 是否需要处理创建前已经存在的消息。使用 0 时,Redis 将初始位置设为 Stream 起点之前,也就是 0-0;之后使用 XREADGROUP 的 > 读取尚未投递的新消息时,现有 Entry 仍在该 group 的可投递范围内。
使用 $ 时,Redis 把创建 group 时 Stream 的最后一条 Entry 作为初始 last-delivered-id。创建前的历史 Entry 位于该位置之前,因此后续使用 > 读取时,通常只会获得创建之后新增且尚未投递给该 group 的消息。
| 起点 | 创建后的 group 位置 | 适用场景 |
|---|---|---|
0 |
last-delivered-id 从 0-0 起步 |
需要回放已有历史消息 |
$ |
指向创建时最后一条 Entry | 只处理创建后的新消息 |
验证创建结果
创建完成后,用 XINFO GROUPS 检查 group 的状态。
redis-cli --raw XINFO GROUPS orders:group-demo预期结果中至少应包含以下关键信息:
name
order-workers
consumers
0
pending
0
last-delivered-id
<ID>这里的 <ID> 应与创建 group 前第二次 XADD 返回的实际 Entry ID 一致。Redis 7.0 及以上版本通常还会返回 entries-read、lag 等字段,不同版本的完整字段数量可能不同。
此时 consumers 为 0、pending 为 0 都是正常现象,因为创建 group 本身既不会创建 consumer,也不会投递消息。确认 group 名称正确,且 last-delivered-id 与所选起点一致,就说明消费组初始化符合预期。