Redis 与缓存 / 系统课时

处理待确认消息

处理待确认消息

本课解决消费者领取消息后宕机,未完成任务如何被发现和接管的问题。完成后,你可以查看 PEL 摘要与明细、确认成功消息,并将空闲时间过长的消息重新分配给其他消费者。

学习目标

  • 使用 XPENDING 查看待确认消息
  • 使用 XACK 确认已完成消息
  • 使用 XCLAIM 接管超时任务

PEL 的作用

PEL 保存已经交付但尚未确认的消息,并记录消息 ID、所属消费者、空闲时间和投递次数。确认只改变待确认状态;原始条目的清理由 XTRIM 或 XDEL 单独负责。

Stream 待确认消息状态图

构造并查看待确认消息

下面让 consumer-a 领取两条任务但暂不确认,从而构造 PEL。

bash
DEL stream:jobs
XADD stream:jobs 1-0 jobId J1001
XADD stream:jobs 2-0 jobId J1002
XGROUP CREATE stream:jobs workers 0-0
XREADGROUP GROUP workers consumer-a COUNT 2 STREAMS stream:jobs >
XPENDING stream:jobs workers

预期输出:

text
(integer) <DELETED_KEY_COUNT>
"1-0"
"2-0"
OK
1) 1) "stream:jobs"
   2) 1) 1) "1-0"
         2) 1) "jobId"
            2) "J1001"
      2) 1) "2-0"
         2) 1) "jobId"
            2) "J1002"
1) (integer) 2
2) "1-0"
3) "2-0"
4) 1) 1) "consumer-a"
      2) "2"

<DELETED_KEY_COUNT> 取决于执行前键是否存在。摘要只能看到总数和消费者分布;使用 XPENDING stream:jobs workers - + 10 可查看每条消息的消费者、空闲毫秒数和投递次数。

确认成功消息

假设任务 1-0 已处理成功,确认后再次查看 PEL。

bash
XACK stream:jobs workers 1-0
XPENDING stream:jobs workers

预期输出:

text
(integer) 1
1) (integer) 1
2) "2-0"
3) "2-0"
4) 1) 1) "consumer-a"
      2) "1"

XACK 返回实际确认的消息数量;重复确认同一 ID 会返回 0。确认前应先保证数据库写入或外部调用已经完成。

接管超时消息

下面把消息 2-0 从 consumer-a 转给 consumer-b。最小空闲时间设为 0 仅用于立即演示。

bash
XCLAIM stream:jobs workers consumer-b 0 2-0
XPENDING stream:jobs workers - + 10

预期输出:

text
1) 1) "2-0"
   2) 1) "jobId"
      2) "J1002"
1) 1) "2-0"
   2) "consumer-b"
   3) (integer) <IDLE_MILLISECONDS>
   4) (integer) 2

生产环境应把最小空闲时间设置为高于正常处理时长的值,避免仍在执行的任务被提前抢走。Redis 6.2 及以上还可使用 XAUTOCLAIM 扫描并接管超时消息,减少客户端自行分页的工作。

消息可能在业务成功但 XACK 前再次投递,因此消费逻辑必须幂等,例如使用业务唯一键防止重复扣款或重复创建记录。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理待确认消息

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

登录哪都通