Redis LMPOP 怎么按需批量取队列：COUNT、方向与空队列判断

把 Redis 列表当作待处理队列时，常见写法是依次检查多个 key，再对第一个有数据的列表执行 LPOP 或 RPOP。这样既多了一次往返，也容易在“刚检查完、数据又被取走”的间隙做出错误判断。Redis 7.0 引入的 LMPOP 把“找第一个非空列表”和“批量弹出”合成一次命令，适合把多个优先级队列按固定顺序消费。

LMPOP 会按传入 key 的顺序寻找第一个非空列表，再从它的左端或右端弹出最多 COUNT 个元素；所有列表都为空时返回空结果，而不是报错。

LMPOP 解决的是哪一段队列逻辑

假设系统有三个待处理列表：queue:urgent、queue:normal 和 queue:slow。业务要求优先消费 urgent，只有它为空才看 normal，最后才看 slow。旧代码通常要先对每个 key 发 LLEN，确认长度后再发一次弹出命令。队列越忙，这组检查越容易被并发消费者打断。

LMPOP 的 key 顺序本身就是调度规则。它从左到右找到第一个非空列表，然后只在这个列表上完成弹出；因此不能把三个 key 当作“随机挑一个有数据的队列”。

图中的 STOP 表示已经命中第一个非空列表，扫描不会继续落到后面的候选 key。

最小命令：用 COUNT 控制一次取多少

先准备两条列表。LPUSH 会把元素放到列表左端，所以这组命令执行后，queue:urgent 的头部是 pay-103：

LPUSH queue:urgent pay-101 pay-102 pay-103
LPUSH queue:normal email-201 email-202
LMPOP 2 queue:urgent queue:normal LEFT COUNT 2

命令的语法是 LMPOP numkeys key [key ...] LEFT|RIGHT [COUNT count]。上面的调用优先命中 queue:urgent，从左侧取出两个元素；在 RESP2 中，结果可理解为：

1) "queue:urgent"
2) 1) "pay-103"
   2) "pay-102"

这里的 COUNT 2 不是“保证返回两个”。如果命中的列表只剩一个元素，就只返回一个；如果三个列表都为空，则返回 nil/null。消费端应先判断空结果，再读取返回结构中的 key 和元素数组。

LEFT 和 RIGHT 不只是写法差异

生产者和消费者必须约定同一端。用 LPUSH 产生“最新任务在左端”的列表时，LEFT 是后进先出；如果希望先处理较早写入的任务，可以改成 RIGHT，但要同时确认生产顺序和重试策略都能接受这个方向。

空队列与返回结果怎么在代码里处理

应用层不要先用 EXISTS 或 LLEN 猜测结果。直接执行 LMPOP，将空响应当作“本轮没有可消费任务”，短暂等待或转入下一轮；将非空响应中的第一个值当作实际命中的队列 key。

LMPOP 3 queue:urgent queue:normal queue:slow RIGHT COUNT 10

这条命令最多从一个列表取 10 个元素，不会把三个列表各取 10 个。若 urgent 有 3 个任务，即使 normal 有 20 个任务，本次也只返回 urgent 的 3 个；下一轮调用才会重新从 urgent 开始判断。

上线前要避开的三个边界

不要把 LMPOP 当成阻塞消费

LMPOP 没有等待语义，空了就立即返回。需要等待新任务时，应评估 BLMPOP 的阻塞行为，以及连接占用、超时和消费者退出处理；不要在高并发下用很短的循环无间隔空转。

不要忽略命中 key 的变化

返回结果里带有实际弹出元素的 key，这个值可以用于指标统计，例如分别记录 urgent 与 normal 的消费量。不要把请求中第一个 key 固定写成命中队列，否则优先队列为空时，监控会把 normal 的任务错误归到 urgent。

集群中先检查多 key 路由

Redis 官方文档提示，LMPOP 的行为在集群环境中需要结合多 key 操作规则判断。部署到 Redis Cluster 前，应让参与一次调用的列表 key 使用一致的 hash tag，或改成单 key 消费方案；不要等线上出现跨槽错误后再拆命令。

相关问题

LMPOP 和 LPOP 有什么区别？

LPOP 面向一个 key，LMPOP 可以按顺序检查多个 key，并从第一个非空列表批量弹出。

COUNT 省略时会返回多少个元素？

默认返回一个元素；写了 COUNT 后，返回数量取列表剩余长度与 COUNT 的较小值。

所有候选列表为空会报错吗？

不会。命令返回 nil 或 null，具体表现取决于客户端使用 RESP2 还是 RESP3。

小结

把多个候选列表按优先级交给 LMPOP，可以在一次调用中完成“选队列、定方向、批量取数”。真正需要留意的不是命令长度，而是 numkeys 与 key 数量、COUNT 的上限语义、空结果分支和 Cluster 跨槽约束。把这四项写进消费端的检查清单，队列切换时就不容易出现漏取或误记。