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 不会替客户端保存这个变量或消费进度。
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"预期输出
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 秒,并用 $ 表示只关心调用开始后出现的消息。
(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 '$'预期输出
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 消费组机制。