Redis ZSET 怎样查询分数区间内的成员

Redis ZSET 按分数区间查询，Redis 6.2 及以上优先使用 ZRANGE key min max BYSCORE；老版本则使用 ZRANGEBYSCORE key min max。默认边界是闭区间，给边界加左括号可以排除该分数，WITHSCORES 可以把成员和分数一起返回。

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

这里的性能基线不是某次本机压测数字，而是返回结果数量 M：官方给出的复杂度为 O(log(N)+M)。所以查询条件正确只是第一步，还要避免在大集合上无界拉取大量成员。

先确认两个数字代表分数，不是排名

ZSET 的成员按 score 升序组织；如果两个成员分数相同，它们再按成员字符串的字典序排列。按区间查询时，min 和 max 是分数边界，不是像普通 ZRANGE key start stop 那样的下标。

查询一个闭区间，并决定是否带回分数

# 删除隔离演示键，避免把旧成员混进结果
DEL demo:zset:score-range

# 写入成员和分数；同一个 member 再次写入会更新它的 score
ZADD demo:zset:score-range 72 "api" 86 "cache" 91 "queue" 91 "stream" 97 "search"

# 查询 90 到 95 的闭区间，并把每个成员的 score 一起返回
ZRANGE demo:zset:score-range 90 95 BYSCORE WITHSCORES

这条查询应命中 score 为 91 的两个成员，返回顺序先按分数，再在同分时按成员字典序。业务代码如果需要展示“成员对应多少分”，应保留 WITHSCORES 的成对返回关系，不要只取偶数或奇数位置后再猜测映射。

开区间、无界区间和倒序要写清楚

Redis 用边界前的 ( 表示排除该边界。例如 (90 95 表示大于 90 且小于等于 95；90 (95 则排除 95。若一端没有业务上限，可以用 -inf 或 +inf，不要把很大的业务数字当成“无限”。

# 排除 90，只保留 90 到 95 之间的成员
ZRANGE demo:zset:score-range (90 95 BYSCORE WITHSCORES

# 查询不低于 90 的所有成员；上界使用正无穷
ZRANGE demo:zset:score-range 90 +inf BYSCORE WITHSCORES

# 从高分到低分返回 95 到 90；REV 模式下把较高分写在前面
ZRANGE demo:zset:score-range 95 90 BYSCORE REV WITHSCORES

# 旧版 Redis 没有 ZRANGE BYSCORE 时使用兼容命令
ZRANGEBYSCORE demo:zset:score-range 90 95 WITHSCORES

ZRANGE ... BYSCORE 是 Redis 6.2 起的统一写法，它还可以配合 REV 和 LIMIT。如果线上仍有旧版本，先确认客户端和服务端支持的命令，再决定是否统一改写；不要把按下标的 ZRANGE key 0 10 误当成按分数查询。

用 LIMIT 控制返回量，别让分页变成无界读取

当一个区间可能命中很多成员时，先把每页大小定为明确的 count。复杂度中的 M 会随返回条数增长，固定页大小能同时控制响应体和客户端解析压力。

offset 分页适合结果在翻页期间基本稳定的场景。若成员会频繁新增、删除或更新 score，前一页之后结果集可能已经变化，后续页可能出现重复或遗漏；这时要把“查询时刻的一致性”作为接口契约重新设计，而不是只把 offset 加 20。

同分成员的字典序也会影响边界附近的展示顺序。若业务要求稳定排序，应让成员命名规则和分页策略共同承担这个约束；只记录最后一个 score、却不记录同分成员的次序，仍可能在并发更新时产生不稳定结果。

常见问题

为什么查询 90 到 95 没有返回 95？ 先确认是否写成了 90 (95，右边括号会排除 95；还要确认成员的实际 score 是否就是 95。

为什么返回结果很多？ 分数范围可能本来就很宽。使用 LIMIT offset count 限制单页数量，或先用 ZCOUNT 了解命中规模。

ZRANGE 和 ZRANGEBYSCORE 怎么选？ Redis 6.2 及以上优先用 ZRANGE ... BYSCORE；需要兼容更老版本时继续用 ZRANGEBYSCORE。

实际落地时可以按这个顺序判断：先确认两个边界是 score，再明确是否包含端点；需要展示分数就加 WITHSCORES，需要倒序就使用 REV，结果可能很大就加 LIMIT。这样查询语义和返回成本都能在命令层表达清楚。