Redis LPOS 怎样定位列表中重复值的位置

Redis 列表中同一个值出现多次时，LPOS 可以直接返回这些匹配项的零基位置。要定位全部重复值，使用 COUNT 0；要从第几个匹配项开始，用 RANK；要控制最多扫描多少个列表元素，用 MAXLEN。

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

最常用的写法是 LPOS key element COUNT 0：它返回所有匹配位置组成的数组。没有匹配项时，是否写了 COUNT 会决定结果是 nil/null 还是空数组。

先把重复值变成位置数组

LPOS key element 默认从列表头部向尾部寻找第一个匹配项，返回单个零基索引。列表里的 c 如果出现多次，不能只用这个默认形式回答“所有 c 在哪里”，需要显式加上 COUNT。

# 创建一个独立演示列表，元素顺序决定最终索引
redis-cli DEL demo:lpos:orders
redis-cli RPUSH demo:lpos:orders a b c 1 2 3 c c c

# 默认只返回从头找到的第一个 c，索引从 0 开始
redis-cli LPOS demo:lpos:orders c

# COUNT 0 表示返回全部匹配位置，而不是只返回一个位置
redis-cli LPOS demo:lpos:orders c COUNT 0

按这组数据，c 的位置是 2、6、7、8，所以 COUNT 0 返回一个包含四个索引的数组。索引是列表的实际位置，不会因为使用正向或反向 RANK 就改成负数。

RANK 怎样定位第 N 个重复值

RANK 不是列表下标，而是“第几个匹配项”。RANK 1 表示从头部方向找到的第一个匹配项，RANK 2 表示第二个；负数则从尾部开始计数，RANK -1 表示从尾部方向找到的第一个匹配项。

# 第 2 个 c：从头向尾数匹配项，返回它在列表中的真实索引
redis-cli LPOS demo:lpos:orders c RANK 2

# 从尾部找第 1 个 c，返回的仍然是零基正向索引
redis-cli LPOS demo:lpos:orders c RANK -1

如果列表是 [a,b,c,1,2,3,c,c,c]，正向第二个 c 的位置是 6，反向第一个 c 的位置是 8。反向只改变搜索方向，不改变输出索引的坐标系。

COUNT 怎样限制返回数量

当 COUNT 是正整数时，LPOS 最多返回指定数量的匹配位置。它和 RANK 可以组合：先按 RANK 跳到某个匹配项，再继续收集最多 COUNT 个位置。

# 从头开始收集前两个 c，数组顺序也是从头到尾
redis-cli LPOS demo:lpos:orders c COUNT 2

# 从尾部方向收集两个 c，结果按尾到头的扫描方向返回
redis-cli LPOS demo:lpos:orders c RANK -1 COUNT 2

# 从第 2 个正向匹配项开始，继续收集最多两个位置
redis-cli LPOS demo:lpos:orders c RANK 2 COUNT 2

需要全部位置时，COUNT 0 比传一个很大的数字更清楚：它明确表达“返回所有匹配项”。如果调用方只需要首个位置，就不要为了统一返回数组而强行加 COUNT，因为返回类型和未命中语义会随之变化。

MAXLEN 怎样限制扫描范围

MAXLEN 告诉 LPOS 最多比较多少个列表元素。它适合“匹配项通常靠近头部或尾部，但不能让一次查找无限扫描”的场景。配合正向 RANK 时，窗口从头部方向计算；配合负向 RANK 时，窗口从尾部方向计算。

# 只检查列表头部的前 5 个元素，找不到时不继续向后扫描
redis-cli LPOS demo:lpos:orders c COUNT 0 MAXLEN 5

# 反向查找时只检查列表尾部的前 4 个元素
redis-cli LPOS demo:lpos:orders c RANK -1 COUNT 0 MAXLEN 4

这里的取舍很明确：限制扫描范围能控制最坏工作量，但也可能漏掉窗口之外的匹配项。不能把 MAXLEN 100 得到的“没有结果”解释成整个列表没有目标值，只能解释为“前 100 个被扫描元素没有找到”。

区分 nil、null 和空数组

LPOS 没有匹配项时，返回结果取决于是否使用了 COUNT。不带 COUNT 时，RESP2 是 nil、RESP3 是 null；带了 COUNT 时，即使没有匹配项，也返回空数组。客户端封装可能把这些值映射成各自语言的 nil、null 或空切片，业务层应保留这个区别。

# 不带 COUNT：未命中是 nil/null，适合“只取一个位置”
redis-cli LPOS demo:lpos:orders missing

# 带 COUNT：未命中是空数组，适合“批量读取位置”
redis-cli LPOS demo:lpos:orders missing COUNT 0

如果接口协议要求统一数组，可以在应用层把未命中的单值结果转换为空数组，但要先确认这不会掩盖“命令参数错误”或“键类型错误”。不要把未命中写成位置 0，因为 0 本身是列表头部的合法索引。

按场景选择 LPOS 写法

LPOS 的平均复杂度是 O(N)，其中 N 是列表元素数量；靠近头部或尾部查找，或者设置了 MAXLEN 时，文档说明某些场景可以接近常数时间。最终命令应按列表长度、匹配位置和漏检容忍度选择，不能只因为加了 COUNT 就认为扫描成本消失。

常见问题

LPOS 返回的位置为什么不是从 1 开始？

Redis List 的位置是零基索引，第一个元素是 0，第二个元素是 1。RANK 的匹配序号从 1 开始，但它和输出位置是两套不同的编号。

COUNT 0 是不是不返回结果？

不是。LPOS 中 COUNT 0 表示返回全部匹配位置；没有匹配项时才返回空数组。

MAXLEN 设置得很大就等同于完整扫描吗？

只有当它覆盖了实际需要检查的列表范围时才接近完整扫描。它本质上仍然是扫描上限，不能把窗口外的元素纳入结论。