Redis 与缓存 / 系统课时

划分业务处理边界

划分业务处理边界

本课解决消费消息时最容易混淆的三个动作:读取、执行业务、确认。重点是明确每一步的成功条件和崩溃窗口,从而判断消息何时可能重复处理、何时可能丢失业务动作,以及幂等机制应该放在哪里。

学习目标

  • 区分消息读取、业务处理和 XACK 的职责
  • 理解未确认消息进入 Pending Entries List 后为什么可能再次被处理
  • 能按幂等要求划定安全的业务处理边界

三个动作分别负责什么

在消费组中,XREADGROUP 负责把消息交给消费者;业务代码负责执行数据库更新、调用下游接口等实际动作;XACK 则告诉 Redis:这条消息已经完成当前消费组的处理,可以从 Pending Entries List(PEL)中移除。

这三个动作不是一个跨 Redis 与业务系统的原子事务。消息被读取后就可能进入 pending 状态,但这并不表示业务已经成功;同样,XACK 成功也只能证明消费组完成了确认,不能证明数据库、HTTP 服务等外部系统与 Redis 完成了原子提交。

Redis Streams 读取、处理与确认的边界

识别重复与丢失窗口

最典型的重复窗口是:消费者已经完成业务操作,但在发送 XACK 前进程崩溃。Redis 仍把这条消息保留在 PEL 中。恢复后,同一消费者可以读取属于自己的 pending 消息,其他消费者也可以通过 XCLAIM 或 XAUTOCLAIM 接管满足空闲时间条件的 pending 消息,因此业务动作可能再次执行。

要注意,XREADGROUP ... STREAMS orders > 只读取尚未投递给该消费组的新消息,不会自动返回历史 pending 消息。可靠消费必须额外设计 pending 恢复或接管流程,不能把“未确认”误解为 Redis 会立即自动重放。

反过来,如果先执行 XACK 再执行业务,进程可能在确认成功后、业务执行前崩溃。此时消息已经离开 PEL,却没有完成业务动作,形成更难恢复的丢失窗口。因此常见边界是业务成功后再确认,并用幂等机制承接可能发生的重复执行。

用可运行示例验证边界

下面使用独立的演示 Stream 创建消费组、写入消息、读取并确认。示例会先删除 orders-boundary-demo,不要把该键名替换成需要保留数据的生产 Stream。

bash
redis-cli DEL orders-boundary-demo >/dev/null
redis-cli XGROUP CREATE orders-boundary-demo orders-group 0 MKSTREAM >/dev/null
ID=$(redis-cli --raw XADD orders-boundary-demo '*' order_id 1001)

# 新消息被读取后进入消费组的 PEL
redis-cli --raw XREADGROUP GROUP orders-group worker-1 COUNT 1 STREAMS orders-boundary-demo '>'
echo "pending_before_ack=$(redis-cli --raw XPENDING orders-boundary-demo orders-group | sed -n '1p')"

# 只有业务成功后才应执行确认
ACKED=$(redis-cli --raw XACK orders-boundary-demo orders-group "$ID")
printf 'acked=%s\n' "$ACKED"
echo "pending_after_ack=$(redis-cli --raw XPENDING orders-boundary-demo orders-group | sed -n '1p')"

预期输出

text
orders-boundary-demo
<ID>
order_id
1001
pending_before_ack=1
acked=1
pending_after_ack=0

<ID> 是 XADD 在运行时生成的消息 ID,实际值会不同。关键现象是:消息读取后 pending 数量变为 1,XACK 返回 1 后 pending 数量回到 0。这说明读取与确认之间确实存在一个可观察、可恢复的处理窗口。

用幂等性承接失败重试

可靠消费通常把“业务处理”和“消息确认”设计成两个明确阶段:先执行并验证业务操作已经成功,再调用 XACK。如果进程恰好在两者之间崩溃,恢复流程重新处理 pending 消息时,业务操作必须能够安全重复执行。

例如处理订单消息时,可以使用 order_id 作为幂等键,通过数据库唯一约束、条件更新或独立的处理记录保证同一业务命令只产生一次有效副作用。这样即使同一 Stream 消息被执行两次,也不会重复创建订单、重复扣款或重复发放权益。

当业务无法天然幂等时,需要显式设计去重状态或补偿机制。目标不是保证消费代码在物理意义上永远只运行一次,而是让“业务已成功、消息尚未确认”这个不可消除的失败窗口不会造成不可控的重复副作用。

划定安全边界

判断边界时先定义什么状态才算业务成功,再规定只有达到该状态才允许 XACK,最后验证进程在业务完成前、业务完成后以及确认前后崩溃时分别会发生什么。只要 pending 恢复流程明确,并且重复执行能够被幂等、去重或补偿机制承接,Redis Streams 的确认语义才能真正与业务可靠性对齐。

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

目录与阅读设置

记录一个想法

划分业务处理边界

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

登录哪都通