Redis List实现循环队列：RPOPLPUSH与原子操作应用

Redis的List并不能直接作为循环队列使用，因其本身缺乏自动回绕和容量限制机制；若需实现固定长度的伪循环队列，必须结合RPUSH与LTRIM手动控制长度，而RPOPLPUSH仅能轮转单个元素、无法替代限长逻辑；并发场景下，“检查+删头+加尾”等多步操作必须通过Lua脚本封装以保障原子性，否则极易因竞态导致容量失控；虽然Stream凭借MAXLEN参数更贴近循环语义，但在需要随机访问、中间修改或灵活弹出/重入等场景中，List仍是不可替代的选择——真正决定方案成败的，不是命令怎么写，而是对容量边界、原子性范围与读写模式的精准对齐。

Redis List能直接当循环队列用吗？

不能。Redis 的 LPOP 和 RPOP 是单向出队，LPUSH/RPUSH 是单向入队，本身不带“自动回绕”逻辑。所谓“循环队列”，本质是容量固定、满时覆盖最老元素，或读到尾自动跳回头——List 本身没这个语义，得靠客户端或服务端逻辑补全。

RPOPLPUSH 实现“伪环”的真实代价

RPOPLPUSH 把一个元素从右弹出再推到左，看起来像轮转，但注意：它只是移动一个元素，不是移动整个队列；它不检查长度，也不丢弃旧数据。想靠它模拟固定长度循环队列，必须自己控制 LLEN + LTRIM 配合，否则列表会无限增长。

• 典型错误：只用 RPOPLPUSH src dst 循环调用，结果 src 越来越空，dst 越来越长，根本不是环
• 正确做法：入队统一走 RPUSH key value，再紧跟 LTRIM key -N -1（保留最后 N 个），N 即“环容量”
• 性能影响：每次 LTRIM 是 O(N)，但 Redis 对小列表优化较好；若 N 是几百以内，实际开销可忽略

原子性边界在哪？别把业务逻辑塞进单条命令

单条 RPOPLPUSH 是原子的，但“检查长度→删头→加尾”这一串不是。比如想实现“超长则删头再入尾”，必须用 Lua 脚本保证原子性，否则并发写可能突破容量上限。

• 常见错误：先 LLEN 判断，再 LPUSH+LTRIM，中间有竞态窗口
• 推荐方案：用 Lua 脚本封装，例如 EVAL "if redis.call('llen',KEYS[1]) >= tonumber(ARGV[1]) then redis.call('lpop',KEYS[1]) end; redis.call('rpush',KEYS[1],ARGV[2]); return 1" 1 myqueue 100 item123
• 注意：Lua 中 redis.call 抛异常会中断整个脚本，别在脚本里做网络请求或耗时计算

为什么不用 Redis Stream？

Stream 天然支持 maxlen 限长（XADD key MAXLEN ~ N ...），自动丢弃最老消息，语义更贴近循环队列。但它不支持随机索引访问，也不能从中间弹出——如果你需要“取一个、处理完再放回去”这类操作，List + LTRIM 仍是更灵活的选择。

• 选 List 的场景：需频繁 LINDEX 查看某位元素、或用 LSET 修改中间值
• 选 Stream 的场景：纯追加+消费模型，且严格要求“最多存 N 条”，不想手写限长逻辑
• 兼容性提醒：MAXLEN ~ 模式（近似裁剪）从 Redis 5.0.5 开始支持，旧版本只能用精确 MAXLEN N，会多一次长度判断开销

真正卡住人的从来不是“怎么写那几行命令”，而是想当然认为 RPOPLPUSH 自带环形语义，或者把 LTRIM 当成免费操作而忽略它对大列表的实际影响。容量阈值、原子性范围、读写模式——这三个点没对齐，代码跑得越快，错得越隐蔽。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Redis List实现循环队列：RPOPLPUSH与原子操作应用》文章吧，也可关注golang学习网公众号了解相关技术文章。