Sorted Set 字典序范围怎么配置或排查

Redis Sorted Set 的字典序范围查询，先看一个容易被忽略的前提：参与比较的 member 必须使用相同 score。满足这个前提后，Redis 6.2 及以上优先写成 ZRANGE key min max BYLEX；老项目仍会看到 ZRANGEBYLEX。如果 score 不一致、把字典序写成分数范围，或者误解了 [ 与 (，结果为空或范围偏一项就很常见。

要按 member 的字典序取一段数据，就把同一 Sorted Set 的 score 固定为同一个值，再用 BYLEX 配置 min/max；空结果优先检查 score 一致性和边界符号。

先把有序集合建成可按字典序查询的形状

字典序查询比较的是 member，而不是 score。Redis 官方文档明确说明：只有当有序集合中的元素都以相同 score 插入时，按字典序取范围才有确定含义；score 不同，返回元素是不确定的。下面用一组商品编码演示，所有 member 都写入 score 0。

redis-cli
# 中文注释：所有成员使用同一个 score，才让字典序成为主要排序依据
ZADD catalog:sku 0 apple-01 0 apple-02 0 banana-01 0 banana-09 0 pear-01
# 中文注释：先用普通范围读取确认 key 中确实有这些成员
ZRANGE catalog:sku 0 -1

这时 apple-01、apple-02、banana-01 等成员可以按字节序比较。它不是按中文拼音、自然语言排序或业务 locale 排序；Redis 的比较是逐字节进行的，混合大小写、数字补零和非 ASCII 字符时尤其要先约定编码规则。

范围符号决定取不取边界成员

Redis 6.2 起，推荐把旧的 ZRANGEBYLEX key min max 写成统一的 ZRANGE key min max BYLEX。min 和 max 前面的符号就是边界配置：左方括号表示包含，左圆括号表示排除。无界范围用单独的 - 和 +。

# 中文注释：包含 apple-01，包含 banana-09
ZRANGE catalog:sku [apple-01 [banana-09 BYLEX

# 中文注释：排除 apple-01，但仍包含 banana-09
ZRANGE catalog:sku (apple-01 [banana-09 BYLEX

# 中文注释：读取整个字典序范围，适合先确认数据形状
ZRANGE catalog:sku - + BYLEX

注意语法中的括号不是成对包住字符串，而是直接附在边界值前面。把 [apple-01 写成 apple-01，或者把 (apple-01 的圆括号漏掉，都会改变结果。

范围符号和空结果要一起排查

遇到“明明有数据却查不到”，按下面的顺序缩小问题范围。先确认 key 类型和成员，再确认 score，最后才调整 min/max；不要一上来把边界改成 - +，否则可能掩盖真正的数据写入问题。

# 中文注释：抽查两条成员的分值，确认字典序查询前提
ZSCORE catalog:sku apple-01
ZSCORE catalog:sku banana-09

# 中文注释：统计范围内数量，排查边界和 LIMIT 是否造成误判
ZLEXCOUNT catalog:sku [apple-01 [banana-09

# 中文注释：分页时排除上一页游标，避免重复返回最后一项
ZRANGE catalog:sku (apple-02 [pear-01 BYLEX LIMIT 0 20

ZLEXCOUNT 只统计符合字典序边界的成员，适合和实际读取数量互相对照。查询复杂度通常为 O(log(N)+M)，其中 M 是返回数量；生产分页仍应给 LIMIT，避免一次取出过大的范围。

旧命令兼容和实际取舍

如果客户端封装还没有统一到新语法，可以继续使用 ZRANGEBYLEX catalog:sku min max [LIMIT offset count]；迁移新代码时优先采用 ZRANGE ... BYLEX，这样与按 rank、score 的范围接口更统一。无论使用哪种命令，都不能省略“相同 score”这个数据约束。

一个实用的排查清单是：先 TYPE catalog:sku 确认是 zset，再用 ZRANGE catalog:sku 0 -1 WITHSCORES 看成员和分值，最后用 ZRANGE catalog:sku - + BYLEX LIMIT 0 20 验证完整范围。确认数据形状后，再收紧 min/max。

相关问题

Sorted Set 字典序查询能否混用不同 score？

不要依赖。官方说明不同 score 时返回元素未指定；如果业务要按 member 字典序查询，应在写入时统一 score。

[ 和 ( 的区别是什么？

[ 包含边界成员，( 排除边界成员；分页常用圆括号排除上一页最后一个 member。

Redis 6.2 以前怎么写？

使用 ZRANGEBYLEX key min max，需要分页时在末尾追加 LIMIT offset count；新版本写新代码则优先使用 ZRANGE ... BYLEX。