Redis XTRIM MAXLEN 与 MINID 适合什么保留策略

Redis Stream 的保留策略，关键不是记住一条命令，而是先确定你要限制“留下多少条”，还是要限制“最早允许留下哪个 ID”。固定条数用 MAXLEN，例如只保留最近 10000 条事件；按时间窗口或事件游标清理，则用 MINID。大多数只想控制内存的场景可以接受 ~ 近似裁剪，只有硬配额或严格边界才使用精确裁剪。

官方文档：https://redis.io/docs/latest/commands/xtrim/

Redis XTRIM：MAXLEN 和 MINID 先按保留目标选策略

MAXLEN 的阈值是非负整数，意思是“最多保留多少条”。它天然适合日志最近 N 条、告警最近 N 条、热点事件缓冲这类按数量控制的场景。MINID 的阈值是 Stream ID，所有小于阈值的条目会被淘汰，适合“保留最近 24 小时”或“保留某个事件游标之后的数据”。

两者不要混成“MAXLEN 是快、MINID 是慢”的性能选择。它们首先表达的是不同的业务边界：消息大小和到达速度变化很大时，固定 10000 条并不等于固定保留时长；而 MINID 需要由应用根据时间或业务游标计算出合法的 Stream ID。

近似裁剪还是精确裁剪：先看成本，再看硬约束

Redis 的默认裁剪是精确模式，命令中可以显式写 =。写成 ~ 后，Redis 可以在更有利的内部边界停止，Stream 可能暂时比阈值多出一些条目。官方文档把这种方式定位为更高效的近似裁剪，特别适合作为内存护栏，而不是计费配额。

LIMIT count 可以限制本次裁剪最多检查或驱逐的条目数；在 Redis 6.2 之后可用。它更像工作量旋钮，不会把 MAXLEN 变成 MINID，也不能替代容量监控。对热写入流，宁可用近似策略配合周期性观察，也不要为了追求每次都精确而让裁剪成为写入路径的额外压力。

把 XTRIM 放进写入与复查边界

如果每条消息都应该带着同一条保留规则进入 Stream，可以把裁剪子句放在 XADD；如果生产者很热，或规则需要综合多个指标，也可以先写入，再由定时任务单独执行 XTRIM。两种放置方式都应保留一个复查动作，不要只看命令返回成功。

# 固定条数：允许在宏节点边界近似保留最近 10000 条
redis-cli XTRIM orders:events MAXLEN ~ 10000

# 时间窗口：先由应用把截止时间换成毫秒级 Stream ID
redis-cli XTRIM orders:events MINID ~ 1770000000000-0

# 复查长度和首尾 ID；返回值是本次删除的条目数
redis-cli XLEN orders:events
redis-cli XRANGE orders:events - + COUNT 1

上面的 ID 只是格式示例，不能直接当作你的业务截止时间。实际应用应使用当前时间减去保留周期后得到的毫秒值，并用 -0 表示该毫秒下的起始序号。复查时重点看三件事：删除数是否符合预期、最早 ID 是否越过边界、Stream 长度是否仍在可接受范围。

消费组场景的反例与判断清单

裁剪 Stream 不等于确认消息。存在消费组时，旧条目可能仍被记录在 PEL（Pending Entries List）中。Redis 文档当前提供 KEEPREF、DELREF 和 ACKED 选项：默认 KEEPREF 会删掉 Stream 条目但保留消费组引用；DELREF 同时清理这些引用；ACKED 只清理由所有消费组确认过的条目。选项与版本要和线上 Redis 版本、重放要求一起确认。

因此，消费速度不稳定时不宜只把 MAXLEN 调小来“解决积压”。先用 XINFO GROUPS 观察 lag 与 pending，再决定保留多久、是否允许丢弃未确认记录，以及是否需要死信流。需要严格重放窗口时，MINID 往往比“最近 N 条”更符合业务语义，但它同样不能替代消费确认和幂等处理。

• 只关心内存上限：优先 MAXLEN ~，接受少量超出并监控 XLEN。
• 关心最近一段时间：计算时间 cutoff，使用 MINID ~，并记录 cutoff 的来源。
• 关心严格数量或配额：使用精确模式，评估额外裁剪成本。
• 有消费组且允许重放：先定义 PEL 处理策略，再决定 KEEPREF、DELREF 或 ACKED。

相关问题

MAXLEN 和 MINID 能同时写在一次 XTRIM 里吗？

不能把它们当成两个独立条件叠加在同一条 XTRIM 语法中。需要同时满足数量和时间约束时，通常由写入路径或周期任务分别执行，并对最终边界做复查。

为什么 MAXLEN ~ 10000 后不是正好 10000 条？

因为波浪号表示近似裁剪，Redis 可以在更合适的内部节点边界停止，所以结果可能略高于阈值；严格上限要使用不带波浪号的精确模式。

MINID 的阈值应该写成什么格式？

它应是 Stream ID，例如 1770000000000-0。前半段通常对应毫秒时间，后半段是同一毫秒内的序号；不要把普通 Unix 秒数直接当成完整 Stream ID。