Redis 与缓存 / 系统课时

理解 Pending Entries List

理解 Pending Entries List

Pending Entries List(PEL)记录消费组中“已经投递、尚未确认”的消息状态。理解 PEL 后,你可以用 XPENDING 判断待确认消息归属、空闲时长与投递次数,并据此识别积压、消费者故障和需要重新认领的消息。

学习目标

  • 理解消息何时进入 PEL,以及 XACK 成功后发生什么
  • 能用 XPENDING 查看待确认总量、消费者分布和消息明细
  • 能根据 PEL 判断消费者故障后的恢复需求,并识别重复处理风险

PEL 记录的是什么

在消费组模式下,消费者通过 XREADGROUP 读取新消息时,Redis 会在该消费组的 PEL 中登记一条待确认记录。PEL 跟踪消息 ID、当前消费者、距上次投递的空闲时间和投递次数等状态,而不是复制一份 Stream 消息内容。

同一条 Stream 消息可以在不同消费组中拥有各自独立的待确认状态。对某个消费组执行成功的 XACK 后,该消息会从这个组的 PEL 中移除,但 Stream 中的原消息仍然存在,除非另外执行删除或裁剪操作。

Redis Streams PEL 中消息投递、Pending 与确认的关系

因此,消费闭环应理解为:读取新消息后进入 PEL,业务处理成功后再 ACK;如果消费者在 ACK 前退出,待确认状态仍保留在 PEL 中,后续可以据此恢复。

用 XPENDING 检查待确认消息

下面用一个最小实验创建 Stream 和消费组,让 consumer-a 读取一条消息但暂不确认,然后分别查看 PEL 摘要与明细,最后执行 ACK 验证待确认数量归零。

bash
redis-cli DEL orders >/dev/null
id=$(redis-cli --raw XADD orders '*' order_id 1001 status CREATED)
redis-cli XGROUP CREATE orders order-group 0-0 >/dev/null
redis-cli XREADGROUP GROUP order-group consumer-a COUNT 1 STREAMS orders '>' >/dev/null

echo '--- summary ---'
redis-cli --raw XPENDING orders order-group

echo '--- details ---'
redis-cli --raw XPENDING orders order-group - + 10

echo '--- ack ---'
redis-cli XACK orders order-group "$id"

echo '--- after ack ---'
redis-cli --raw XPENDING orders order-group | head -n 1

预期结果:消息 ID 与空闲毫秒数是动态值,实际结果可能不同。

text
--- summary ---
1
<ID>
<ID>
consumer-a
1
--- details ---
<ID>
consumer-a
<IDLE_MS>
1
--- ack ---
1
--- after ack ---
0

摘要中的 1 表示当前共有一条待确认消息,随后可看到最小和最大消息 ID,以及 consumer-a 名下的 Pending 数量。明细查询会进一步给出消息 ID、消费者、空闲时间和投递次数,适合定位长期未处理的具体消息。

PEL 与故障恢复

消费者退出并不会自动清除其 Pending 消息。恢复时应先用 XPENDING 找出长期空闲的记录,再决定是否由其他存活消费者接管。Redis 提供 XCLAIM 和 XAUTOCLAIM 完成重新认领;重新认领会更新待确认消息的消费者归属,消息仍要在业务处理成功后执行 XACK。

判断 Pending 是否异常

排查时不要只看 PEL 总量。少量、空闲时间很短的 Pending 通常只是正常处理窗口;如果总量持续增长、空闲时间长期升高,或大量记录集中在已经失效的消费者名下,才更像真实积压或故障。

可以把 PEL 看作消费组的“未完成工作账本”:XPENDING 用来发现和定位未确认消息,XCLAIM 或 XAUTOCLAIM 用来转移处理权,XACK 才表示该消费组不再追踪这条消息。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

理解 Pending Entries List

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通