Redis 与缓存 / 系统课时
处理待确认消息
处理待确认消息
本课解决消费者领取消息后宕机,未完成任务如何被发现和接管的问题。完成后,你可以查看 PEL 摘要与明细、确认成功消息,并将空闲时间过长的消息重新分配给其他消费者。
学习目标
- 使用
XPENDING查看待确认消息 - 使用
XACK确认已完成消息 - 使用
XCLAIM接管超时任务
PEL 的作用
PEL 保存已经交付但尚未确认的消息,并记录消息 ID、所属消费者、空闲时间和投递次数。确认只改变待确认状态;原始条目的清理由 XTRIM 或 XDEL 单独负责。

构造并查看待确认消息
下面让 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 前再次投递,因此消费逻辑必须幂等,例如使用业务唯一键防止重复扣款或重复创建记录。
按自己的节奏,确认真正理解。