Redis 与缓存 / 系统课时

使用 XREAD 读取消息

使用 XREAD 读取消息

本课解决如何用 XREAD 从 Redis Stream 的指定位置读取消息,并在客户端持续消费时正确维护读取游标。完成后,你能区分历史回放、断点继续与阻塞等待,并明确 Redis 只负责按起点读取,消费进度必须由应用自己持久化。

学习目标

  • 掌握 XREAD 的 STREAMS key id 读取规则。
  • 能使用消息 ID 从已知位置继续读取,并在处理成功后推进应用游标。
  • 理解 BLOCK 与 $ 的实时等待语义及使用边界。

起点 ID 决定读取边界

XREAD 返回 ID 严格大于指定起点 ID 的消息,因此传入的 ID 是一个排他的读取起点。需要从 Stream 最早位置回放时,可以使用 0-0;应用已经保存了某条消息 ID 时,把该 ID 传给下一次 XREAD,即可继续读取它之后的消息。

$ 的语义不同:它表示执行本次 XREAD 时 Stream 当前已有的最后一个 ID,所以历史消息会被跳过,只等待之后新增的消息。它适合首次启动时表达“从现在开始”,不适合反复作为后续调用的读取位置。

主示例:读取历史并从已知 ID 继续

下面先写入两条消息,从 0-0 读取历史记录,再新增一条消息,并使用第二条消息的 ID 作为下一次读取起点。这里的 LAST_ID 只是演示应用把某个已知 ID 传回 XREAD,Redis 不会替客户端保存这个变量或消费进度。

bash
redis-cli DEL demo:xread:orders >/dev/null
redis-cli XADD demo:xread:orders '*' order_id 1001 status paid >/dev/null
LAST_ID=$(redis-cli --raw XADD demo:xread:orders '*' order_id 1002 status shipped)
redis-cli --raw XREAD COUNT 2 STREAMS demo:xread:orders 0-0
redis-cli XADD demo:xread:orders '*' order_id 1003 status created >/dev/null
redis-cli --raw XREAD COUNT 2 STREAMS demo:xread:orders "$LAST_ID"

预期输出

text
demo:xread:orders
<ID-1>
order_id
1001
status
paid
<ID-2>
order_id
1002
status
shipped
demo:xread:orders
<ID-3>
order_id
1003
status
created

实际消息 ID 会随写入时间变化;示例使用 --raw 固定为逐行输出,便于核对读取边界。COUNT 2 只限制本次调用最多返回两条消息,不会删除消息,也不会让 Redis 记住这个客户端已经读到哪里。

用 BLOCK 等待新消息

不希望客户端频繁轮询时,可以加入 BLOCK,单位是毫秒。下面用一个 Bash 命令模拟两个终端:后台任务等待 1 秒后写入新消息,前台 XREAD 最多阻塞 5 秒,并用 $ 表示只关心调用开始后出现的消息。

bash
(sleep 1; redis-cli XADD demo:xread:orders '*' order_id 1004 status paid >/dev/null) &
redis-cli --raw XREAD BLOCK 5000 COUNT 10 STREAMS demo:xread:orders '$'

预期输出

text
demo:xread:orders
<ID-4>
order_id
1004
status
paid

如果等待期间没有新消息,超时后会返回空结果。$ 通常只用于第一次建立“从现在开始”的位置;一旦已经收到消息,后续阻塞读取应使用上次实际读取到的最后 ID。若每次都重新使用 $,两次调用之间已经到达的消息可能被跳过。

XREAD 只读取,不持久化消费进度

普通 XREAD 没有消费确认、待处理列表或服务端游标。Redis 只根据你本次传入的 ID 决定返回哪些消息;下一次从哪里继续,完全取决于应用传入什么 ID。内存变量只能维持当前进程生命周期,若要在重启后继续消费,就必须把应用认可的消费位置持久化到数据库、文件或其他可靠存储。

还要区分“本次读取到的最后 ID”和“已经成功处理并可提交的游标”。假设一批消息读取到 <ID-3>,但业务只成功处理到 <ID-2>,应用应持久化 <ID-2>,而不是直接记录 <ID-3>。重启后从 <ID-2> 继续读取时,<ID-3> 会再次返回,失败消息不会被直接跳过。

因此,0-0 解决历史回放,具体消息 ID 解决断点继续,$ 解决首次只等待未来消息;真正可靠的普通 XREAD 消费器还必须由应用保存“最后成功处理的 ID”。需要多个消费者协作、消息确认和待处理消息恢复时,再使用 Stream 消费组机制。

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

目录与阅读设置

记录一个想法

使用 XREAD 读取消息

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

登录哪都通