Redis RPOP 命令详细教程
RPOP移除并返回列表表尾（右侧）的最后一个元素，与 LPOP 恰好方向相反，是列表作为队列、栈使用时另一种常用的"出队"命令。它自 Redis 1.0.0 起提供，从 6.2.0 起支持可选的 count 参数，可一次弹出并返回表尾的 count 个元素。
资料合集：https://pan.quark.cn/s/10e98d308913、https://pan.quark.cn/s/f56bc69c5338
一、概览与语法
RPOP key [count]| 项目 | 说明 |
|---|---|
| 数据类型 | List |
| 支持版本 | Redis 1.0.0 起；6.2.0 起支持可选 count 参数 |
| key | 目标列表 Key |
| count | 可选，正整数，弹出并返回表尾后 count 个元素 |
| 返回值 | 不带 count：Bulk 字符串，被弹出的元素，Key 不存在时返回空值；带 count：元素数组，按从表尾向表头的顺序排列，Key 不存在时返回空值，count 超过列表长度时弹出全部 |
| 时间复杂度 | 不带 count 为 O(1)；带 count 为 O(N)，N 为弹出的元素数 |
| ACL | @write、@list、@fast |
| 命令标记 | write、fast |
官方说明：移除并返回存储在 key 的列表的最后一个元素；默认从列表尾部弹出，如果提供了可选的 count 参数，响应将由 count 个元素组成，具体取决于列表的长度。$TRAE_REF
二、基础示例
以下命令在测试实例的 redis-cli 中执行。文中结果是预期说明，未实际连接 Redis 运行。示例沿用官方文档的数据与结果。
DEL tutorial:{rpop}:mylist RPUSH tutorial:{rpop}:mylist "one" "two" "three" "four" "five" RPOP tutorial:{rpop}:mylist RPOP tutorial:{rpop}:mylist 2 LRANGE tutorial:{rpop}:mylist 0 -1预期结果：RPUSH 返回5；第一条 RPOP 返回"five"（表尾元素被移除）；第二条带 count 返回["four","three"]；LRANGE 显示列表只剩["one","two"]。
注意带 count 时返回数组的顺序是从表尾向表头，即先返回离表尾最近的元素，与列表本身的索引方向相反。
三、count 参数详解
- 版本要求：6.2.0 之前不支持 count，老版本执行
RPOP key 2会报语法错误。 - count 超过列表长度：弹出全部剩余元素，不报错。
- count 为 0：返回空数组，列表保持不变。
- 返回顺序：从表尾向表头排列，与 LRANGE 的方向相反。
- 弹空即删 Key：最后一个元素被弹出后 Key 自动删除。
DEL tutorial:{rpop}:mylist RPUSH tutorial:{rpop}:mylist "a" "b" "c" RPOP tutorial:{rpop}:mylist 10 EXISTS tutorial:{rpop}:mylist RPUSH tutorial:{rpop}:mylist "a" RPOP tutorial:{rpop}:mylist 0 LRANGE tutorial:{rpop}:mylist 0 -1预期结果：RPUSH 返回3；count 10 超过列表长度，返回全部元素["c","b","a"]（从表尾向表头）；EXISTS 返回0，列表被弹空后 Key 已删除；重新写入一个元素后，count 0 返回空数组，LRANGE 确认列表仍是["a"]。
四、弹出即删除 Key
Redis 不存在"空列表 Key"：列表的最后一个元素被弹出时，Key 随之删除。因此不能依赖"Key 还在但列表为空"来判断状态，需要用 EXISTS 或 TYPE 重新检查。
DEL tutorial:{rpop}:mylist RPUSH tutorial:{rpop}:mylist "only" EXISTS tutorial:{rpop}:mylist RPOP tutorial:{rpop}:mylist EXISTS tutorial:{rpop}:mylist预期结果：RPUSH 返回1；第一次 EXISTS 返回1；RPOP 返回"only"；第二次 EXISTS 返回0，Key 已随最后一个元素一起被删除。
五、返回值与空结果的区分
| 调用形态 | Key 存在且有元素 | Key 不存在或已弹空 |
|---|---|---|
RPOP key | 单个元素（Bulk 字符串） | 空值 |
RPOP key count | 元素数组（元素数可能少于 count） | 空值 |
两种空值含义一致：都不表示出错，只表示没有元素可弹。RPOP key 0是唯一返回"空数组而非空值"的形态，前提是 Key 存在，说明列表在但没有弹出任何元素。
DEL tutorial:{rpop}:empty RPOP tutorial:{rpop}:empty RPOP tutorial:{rpop}:empty 5预期结果：两条命令都返回空值（Key 不存在），且不会创建该 Key。
六、边界情况与错误处理
| 场景 | 行为 |
|---|---|
| Key 不存在（不带 count） | 返回空值 |
| Key 不存在（带 count） | 返回空值 |
| Key 类型不是 List | 报 WRONGTYPE |
| count 为负数 | 报ERR value is out of range, must be positive |
| count 不是整数 | 报参数错误 |
| 缺少 Key 参数 | 报语法错误 |
| 6.2.0 之前的版本带 count | 报语法错误 |
SET tutorial:{rpop}:str text RPOP tutorial:{rpop}:str RPOP tutorial:{rpop}:mylist -1预期结果：SET 返回 OK；对 String 类型执行报 WRONGTYPE；count 为 -1 报ERR value is out of range, must be positive。
七、与相近命令的区别
| 命令 | 与 RPOP 的区别 |
|---|---|
| LPOP | 从表头（左侧）弹出 |
| BRPOP | 阻塞版，支持多 Key，列表为空时等待 timeout 秒 |
| LMPOP/BLMPOP | 多 Key 按序检查并可批量弹出，7.0 起 |
| LMOVE/BLMOVE | 弹出并转移到另一列表，实现可靠队列 |
| RPOPLPUSH | 表尾弹出并推入目标表头，1.2 起，6.2 起弃用 |
| LREM | 按值删除指定元素，不按位置弹出 |
| RPOP | 从表尾弹出，可与 LPUSH 组成 FIFO 队列 |
选择规则：LPOP 与 RPOP 的区别只在方向。LPUSH入队配RPOP出队、RPUSH入队配LPOP出队，都是先进先出的队列；LPUSH配LPOP、RPUSH配RPOP则是后进先出的栈。
八、客户端示例
前提为已安装 redis-py 并准备好本地测试实例。redis-py 的rpop(name, count=None)：不带 count 返回单个元素或None，带 count 返回元素列表。
importredis r=redis.Redis(host="localhost",port=6379,decode_responses=True)key="tutorial:{rpop}:py"try:r.delete(key)r.rpush(key,"one","two","three","four","five")print(r.rpop(key))# fiveprint(r.rpop(key,2))# ['four', 'three']，从表尾向表头print(r.rpop(key))# twoprint(r.rpop("no-such",5))# None，Key 不存在finally:r.delete(key)r.close()Java（Jedis）示例，rpop(key)返回String或null，rpop(key, 2)返回List<String>：
try(Jedisjedis=newJedis("localhost",6379)){Stringkey="tutorial:{rpop}:java";jedis.del(key);jedis.rpush(key,"one","two","three","four","five");System.out.println(jedis.rpop(key));// fiveSystem.out.println(jedis.rpop(key,2));// [four, three]System.out.println(jedis.rpop(key));// twojedis.del(key);}九、原子性与可靠性
原子性：单条 RPOP 原子完成，多个消费者并发弹出不会拿到同一个元素；不带 count 时每个元素 O(1)，命令标记 fast，适合高频调用。
"弹出后处理"不可靠：这是消费端最大的坑。元素一旦弹出就从 Redis 消失，如果消费者在处理完成前崩溃，该元素彻底丢失。需要"至少一次"投递语义时，改用 LMOVE/BLMOVE 的处理中列表模式：先把元素转移到 processing 列表，处理完成后再删除，崩溃后可重新投递。旧代码常用 RPOPLPUSH 实现同样的效果，它同样已被 LMOVE 取代。
其他：在 MULTI/EXEC 事务、Lua 脚本与管道中正常工作；批量弹出用 count 参数一次完成，优于循环调用单元素 RPOP。
十、典型业务场景
任务队列消费端（表尾出队）：生产者 LPUSH 入队，消费者 RPOP 出队，构成 FIFO 任务队列；也可用 RPUSH 入队配 LPOP 出队，两者等价，只需保证两端方向相反。
最近写入优先的处理场景：生产者 RPUSH 追加，消费者 RPOP 取表尾，实现"后进来的先处理"，例如优先清理最新上报的异常。
日志与历史回溯：把记录 RPUSH 进列表，回溯时从表尾 RPOP 逐条取出，天然按时间倒序处理。
栈顶弹出：LPUSH 压栈配 LPOP 弹栈（或 RPUSH 压栈配 RPOP 弹栈），实现后进先出的回退逻辑。
十一、练习、排错与总结
练习：用tutorial:{rpop}:ex1模拟队列：LPUSH 写入a b c d，连续 RPOP 直到返回空值，验证先进先出；用tutorial:{rpop}:ex2模拟栈：RPUSH 写入x y z，连续 RPOP 验证后进先出；各执行一次带 count 的批量弹出，注意观察返回数组是从表尾向表头排列，并用 EXISTS 观察 Key 被弹空删除的时机。
排错要点：返回空值时用 EXISTS 区分 Key 从未存在与已被弹空；报 WRONGTYPE 时用 TYPE 检查类型；count 传负数报 out of range；老版本报语法错误说明不支持 count 参数；弹出顺序与预期不符时确认使用的是 LPOP 还是 RPOP，以及入队端用的是 LPUSH 还是 RPUSH；线上发现元素"丢失"时优先排查是否为弹出后崩溃，考虑迁移到 LMOVE 处理中列表模式。清理使用DEL tutorial:{rpop}:mylist tutorial:{rpop}:empty tutorial:{rpop}:str tutorial:{rpop}:py tutorial:{rpop}:java tutorial:{rpop}:ex1 tutorial:{rpop}:ex2。速记：1.0 起、6.2 起可带 count、从表尾弹出、单元素 O(1)、Key 不存在返回空值、弹空即删 Key、LPUSH+RPOP 是队列 LPUSH+LPOP 是栈、带 count 返回顺序为表尾向表头、弹出后崩溃会丢元素、可靠场景用 LMOVE/BLMOVE。
