Redis 与缓存 / 系统课时

使用 XACK 确认消息

使用 XACK 确认消息

XACK 用于告诉 Redis:消费组中的指定消息已经由业务逻辑成功处理,可以从该消费组的 Pending Entries List 中移除。正确使用 ACK,关键不是“读到就确认”,而是把确认时机放在业务成功之后。

学习目标

  • 掌握 XACK 的语法、返回值及正确调用时机
  • 理解 ACK 如何把消息从 PEL 中移除
  • 能识别过早 ACK 和漏 ACK 分别带来的数据丢失与重复处理风险

XACK 的基本规则

XACK 的形式很简单:指定 Stream、消费组和一个或多个消息 ID。命令返回被成功确认的消息数量;已经不在该消费组 PEL 中的消息不会再次计入确认数量。

bash
redis-cli XACK <STREAM> <GROUP> <ID>

预期结果:若 <ID> 当前存在于该消费组的 PEL 中并被成功确认,返回整数 1;若该消息已经不在 PEL 中,则通常返回 0。

真正重要的是确认时机。消费者应该先读取消息,再完成必要的业务处理,最后执行 XACK。在业务操作成功前确认,会让 Redis 认为消息已经完成;此时消费者如果随后崩溃,后续恢复流程就失去了这条 Pending 记录。

Redis Streams 从消费到业务成功再到 XACK 的状态转换

用一个完整流程验证 ACK

下面用一个最小流程验证“读取后 Pending、确认后 Pending 消失”。示例中的消息 ID 使用 <ID> 表示,实际值由 Redis 在 XADD 时生成。

bash
redis-cli DEL orders
redis-cli XADD orders * order_id 1001 status CREATED
redis-cli XGROUP CREATE orders order-group 0-0 MKSTREAM
redis-cli XREADGROUP GROUP order-group consumer-a COUNT 1 STREAMS orders >
redis-cli XPENDING orders order-group
redis-cli XACK orders order-group <ID>
redis-cli XPENDING orders order-group

预期结果:第一次 XPENDING 显示 1 条 Pending,最后一次 XPENDING 显示数量变为 0;XACK 本身返回 1。

text
1
1
0 <START_ID> <END_ID> 0 consumer-a
1
0

上面的结果用于表达状态变化,实际消息 ID、时间和 XPENDING 摘要格式中的动态值可能不同。关键判断只有两点:读取后消息进入 PEL,成功执行 ACK 后该消息不再属于 PEL。

ACK 时机决定可靠性

最危险的情况是“先 ACK,后做业务”。例如消费者收到订单消息后立刻 XACK,随后调用数据库更新订单;如果数据库操作失败或进程在调用数据库前崩溃,Redis 已经删除 PEL 记录,消息不会再以 Pending 状态被恢复处理。

更稳妥的顺序是“业务成功,再 ACK”。这样,如果业务处理失败,消息仍留在 PEL 中,可以根据业务幂等设计决定重试;如果业务已经成功但 ACK 失败,则后续可能再次投递,因此业务侧仍需要具备幂等能力。

用 Pending 结果验证确认是否生效

实际排查时,可以把 XPENDING 放在 ACK 前后进行对照。这样比只看 XACK 的返回值更直观,因为你能同时验证消费组是否还保留未确认记录。

bash
redis-cli XPENDING orders order-group
redis-cli XACK orders order-group <ID>
redis-cli XPENDING orders order-group

预期结果:第一条查询的 Pending 数量至少包含待确认消息;XACK 对仍处于 PEL 的消息返回 1;第二条查询中该消息不再出现在待确认集合中。

text
1 <START_ID> <END_ID> 1 consumer-a
1
0

当确认数量异常为 0 时,应检查消息 ID 是否正确、是否属于当前消费组,以及消息是否已经被其他流程确认。不要把 XACK 返回 0 简单理解为 Redis 故障,它也可能只是该消息已经不在当前 PEL。

把 ACK 放进消费代码的正确位置

无论消费者使用哪种编程语言,推荐遵循同一条原则:读取负责获得消息,业务逻辑负责决定成功,ACK 负责记录成功后的确认。对于数据库、HTTP 调用等外部操作,还要明确失败后的重试与幂等策略。

最终可以用一句话判断 ACK 是否放对了位置:如果进程在 ACK 前崩溃,消息仍应能够从 PEL 找回来;如果业务已经成功但 ACK 后崩溃,系统则应能够承受这条消息再次被处理。做到这一点,XACK 才真正成为可靠消费链路的一部分。

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

目录与阅读设置

记录一个想法

使用 XACK 确认消息

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

登录哪都通