Redis ZRANGESTORE 怎样保存一段有序集合排名结果

要把 Redis 有序集合中的一段结果保存下来，直接使用 ZRANGESTORE：它从源 key 读取范围，把匹配成员写入目标 key，并返回目标有序集合中的元素数量。默认范围按零基 rank 解释；如果业务条件是分数或字典序，就显式加上 BYSCORE 或 BYLEX。

官方地址：https://redis.io/docs/latest/commands/zrangestore/

可以把 ZRANGESTORE 理解为“带筛选条件的 ZRANGE + 保存”：dst 是要写入的目标键，src 是源有序集合，min max 决定范围。先确认范围语义，再决定是否使用 REV 和 LIMIT，就不容易把排名窗口写反。

先读懂 ZRANGESTORE 的目标键和范围

命令的基本形态如下：

# 语法中的 dst 是新结果的目标键，src 是已有的源有序集合
redis-cli ZRANGESTORE dst src min max [BYSCORE|BYLEX] [REV] [LIMIT offset count]

dst 和 src 都是 key。min、max 在没有范围修饰符时代表零基 rank，负数从集合末尾计数；加上 BYSCORE 后代表分数边界；加上 BYLEX 后代表字典序边界。官方文档将 max 描述为包含边界，但 score 和 lex 的排除写法仍然要用各自的边界符号。

这个命令从 Redis Open Source 6.2.0 开始提供，时间复杂度是 O(log(N)+M)，其中 N 是源有序集合的元素数，M 是写入目标的元素数。它属于写命令，ACL 分类包含 @write、@sortedset 和 @slow。

用默认 rank 范围保存一段成员

如果需求是“保存第 3 到最后一名”，不要先把成员读到应用层再逐个写回。把源集合准备好后，可以直接把 rank 区间复制为新的 sorted set：

# 准备一个按 score 排序的源集合
redis-cli ZADD leaderboard 10 alice 20 bob 30 carol 40 dave

# rank 从 0 开始，2 到 -1 表示第 3 个成员到最后一个成员
redis-cli ZRANGESTORE top_part leaderboard 2 -1

# 读取保存后的目标集合，确认成员和 score 一起保留
redis-cli ZRANGE top_part 0 -1 WITHSCORES

按这组数据，top_part 会保存 carol 和 dave，返回整数 2。目标不是一个普通字符串列表，而是新的有序集合，因此后续仍然可以用 ZRANGE、ZSCORE 等 sorted-set 命令处理。

默认 rank 适合“第几名到第几名”的窗口。如果你真正想表达的是“分数至少 20”，就不要把数值 20 直接当 rank 使用，应该改用 BYSCORE。

用 BYSCORE 保存分数范围

BYSCORE 把 min max 改成 score 范围。边界默认包含；在边界前加左括号可以排除该边界。例如 (20 表示大于 20，而不是大于等于 20：

# 只保存 score 在 20 到 40 之间的成员，两个边界都包含
redis-cli ZRANGESTORE score_part leaderboard 20 40 BYSCORE

# 排除 20，只保留大于 20 且不超过 40 的成员
redis-cli ZRANGESTORE score_part_exclusive leaderboard \"(20\" 40 BYSCORE

# 目标集合仍然按 score 排序，可以带分数检查结果
redis-cli ZRANGE score_part 0 -1 WITHSCORES

对于 score 范围，-inf 和 +inf 可以表达一侧不封顶的查询。生产代码中建议把范围的单位和边界策略写进调用函数名或参数对象，避免把 rank 数值误当成 score 数值。

如果成员具有同分数，Redis 仍需要按照 sorted set 的规则确定顺序；需要稳定分页时，应该同时设计清楚 score 边界与成员边界，而不是只依赖一次读取返回的序号。

用 BYLEX 复制同分成员的字典序区间

BYLEX 适合所有成员具有相同 score、但业务需要按成员字典序截取的场景。它的范围边界使用 [ 和 ( 表示包含或排除，- 和 + 表示字典序最小与最大：

# 让同一分数下的成员按字典序参与范围选择
redis-cli ZADD same_score 1 alice 1 bob 1 carol 1 dave

# 保存从 bob 到 carol 的字典序范围，左右边界都包含
redis-cli ZRANGESTORE name_part same_score \"[bob\" \"[carol\" BYLEX

# 查看目标集合中的成员
redis-cli ZRANGE name_part 0 -1

BYLEX 的使用前提是相关成员的 score 相同；如果 score 不同，字典序范围不能替代按 score 的筛选。它更适合在同一分组内按名称、编码或游标做稳定截取。

用 REV 和 LIMIT 保存倒序窗口

REV 让结果从高到低排列。LIMIT offset count 用于跳过匹配到的前 offset 个成员，再保存最多 count 个成员。官方限制是：LIMIT 必须和 BYSCORE 或 BYLEX 一起使用，不能直接接在默认 rank 范围后面。

# 按 score 从高到低看 20 分以上的结果，跳过 1 个，保存接下来的 2 个
redis-cli ZRANGESTORE high_window leaderboard 20 +inf BYSCORE REV LIMIT 1 2

# 查看目标窗口；WITHSCORES 便于确认倒序范围是否符合预期
redis-cli ZRANGE high_window 0 -1 WITHSCORES

这里的 offset 和 count 都是针对匹配范围计算的，不是针对整个源集合的原始 rank。若 count 是负数，Redis 会返回 offset 之后的全部剩余成员，因此不要把负数当成“不要写入”的标记。

生产环境要留意目标覆盖和空结果

第一，dst 是写入目标。把它设成已有业务结果键时，应当把“覆盖旧结果”视为明确行为；如果需要保留历史快照，就使用带批次或时间信息的新 key，而不是依赖旧 key 自动留存。

第二，范围没有匹配成员时，目标结果为空，返回数量为 0。调用方应把 0 当成“这次没有生成结果”来处理，不要把它和命令执行失败混为一谈。命令返回的是整数元素数量，而不是返回成员数组。

第三，目标和源是两个 key。在 Redis Cluster 中，多 key 命令会受到 key slot 约束；生产设计要让相关 key 使用同一个 hash tag，或在部署前确认客户端和集群对该命令的支持方式。不要把单机测试环境的调用结论直接当成跨 slot 生产结论。

第四，ZRANGESTORE 是写操作。给应用账号授权时，至少要把目标 key 的写入权限、源 key 的读取权限和 sorted-set 命令权限纳入审计范围，避免只给读取权限后再用重试逻辑掩盖权限错误。

一张表记住参数怎么选

常见问题

ZRANGESTORE 会不会删除源有序集合？

不会。它读取 src 的范围并写入 dst；源 key 仍然保留，除非另有删除或更新命令。

能不能直接用 LIMIT 做 rank 分页？

不能把它当成默认 rank 的附加参数。官方语法要求 LIMIT 依附于 BYSCORE 或 BYLEX；默认 rank 分页应直接调整 rank 的 min 和 max。

为什么目标集合数量比预期少？

先检查边界是否被排除，再检查 REV 后的 offset 是否跳过了匹配成员，最后确认源集合中是否存在同分或同字典序边界导致的范围差异。