Redis 与缓存 / 系统课时
认识 Stream 消息结构
认识 Stream 消息结构
本课解决“Redis Stream 中一条消息由哪些部分组成”的问题。完成后,你可以识别流键、消息 ID、字段和值,并理解 Stream 适合保存按时间追加的事件记录。
学习目标
- 识别 Stream 的层级结构
- 理解消息 ID 的组成和顺序
- 区分 Stream 与简单 List 队列
Stream 的结构
一个 Stream 键代表一条消息流。流中每条 Entry 都有唯一 ID,并携带一个或多个字段和值;不同消息可以使用不同字段,但生产系统通常应保持统一格式。

消息 ID 形如 1710000000000-0。左侧通常是毫秒时间戳,右侧是同一毫秒内的序号。使用 * 时由 Redis 生成递增 ID;手工指定的新 ID 必须大于流中当前最大 ID。
追加并查看消息
为便于得到稳定输出,下面显式使用 ID 1-0。生产代码通常传入 *,并保存 XADD 返回的实际 ID。
bash
redis-cli DEL demo:stream:orders:0807 >/dev/null
echo "xadd:"
redis-cli --raw XADD demo:stream:orders:0807 1-0 orderId 1001 status CREATED amount 99.00
echo "range:"
redis-cli --raw XRANGE demo:stream:orders:0807 - +
echo "length:"
redis-cli --raw XLEN demo:stream:orders:0807预期输出:
text
xadd:
1-0
range:
1-0
orderId
1001
status
CREATED
amount
99.00
length:
1- 和 + 分别表示最小与最大 ID。字段和值都按字符串保存,数值类型、状态含义和必填字段由应用协议解释。
与 List 的区别
List 适合简单先进先出队列;Stream 还提供稳定消息 ID、范围查询、阻塞读取、消费者组和待确认列表。读取 Stream 不会自动删除消息,历史保留需要单独配置裁剪策略。
Stream 也不是完整消息队列的自动替代品。生产系统仍要设计消息幂等、失败重试、容量裁剪、持久化和故障恢复策略。
按自己的节奏,确认真正理解。