首页/数据/Redis 进阶速查/Stream 消息写入:XADD 与 ID 规则
数据结构与选型42 条

Stream 消息写入:XADD 与 ID 规则

Stream 是有序、可持久化、带消费组的消息结构:XADD 生成毫秒时间戳-序号 ID,XRANGE/XREVRANGE 按 ID 范围读取,容量用 MAXLEN/MINID 控制。

Redis 进阶速查数据更新于 2026-10-12
写入XADD key * field value ...
ID 结构毫秒时间戳-序号
读取XRANGE / XREVRANGE / XLEN

示例

示例
redis-cli XADD orders '*' item apple qty 2
redis-cli XADD orders 1730020000000-0 item pear qty 5
redis-cli XLEN orders
redis-cli XRANGE orders - + COUNT 10
首次用 * 自动生成 ID;显式指定时应大于 last-generated-id,否则报错(可先 XINFO STREAM 查看)。

易错点

  • 不限制长度时 Stream 会无限增长,长期运行应在 XADD 时带 MAXLEN
  • 服务器时钟回拨时 * 自动 ID 仍保证单调递增(内部会调整),但记录的时间不再准确

数据来源与参考

  • Redis 官方文档:XADD 命令 / Stream 数据类型
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌