优先用Stream,因其支持消费组、消息持久化、ACK确认、消息回溯与重试;List仅适合低可靠、无确认、单消费者或测试场景,因BRPOP无失败重试、不支持分组消费、消息易丢失且无法回溯。

直接说结论:优先用 Stream,除非你明确只需要“发完就不管”的简单异步任务;List 仅适合低可靠、无消费确认、单消费者或测试场景。
为什么不能只用 LPUSH + BRPOP 做生产级队列
很多人一上来就写 LPUSH 入队、BRPOP 出队,看起来工作正常,但上线后容易踩坑:
-
BRPOP返回消息后,如果消费者处理失败(比如网络抖动、服务重启),这条消息就永久丢失了——List没有重试或未确认队列机制 - 多个消费者并发
BRPOP同一个 key,会竞争消息,但无法保证负载均衡,也无法追踪哪条消息被谁取走 - 没有消息回溯能力:想重放某条历史消息?得自己存日志、再人工补数据
- Redis 连接空闲超时(如
timeout=0时长期阻塞)可能被中间件或云 Redis 主动断连,抛出Connection reset异常
这些不是理论风险,而是真实压测和灰度中高频出现的问题。如果你的业务涉及订单、支付、通知等需要“至少一次”语义的场景,List 就不该是首选。
Stream 的核心命令与 Spring Boot 集成要点
Spring Boot 3.x 默认支持 Stream,但需要手动配置消费者组和 ACK 逻辑,不是开箱即用。
- 创建 Stream 和消费者组必须显式执行:
XGROUP CREATE mystream mygroup $ MKSTREAM,否则XREADGROUP会报错NOGROUP No such consumer group - 消费者必须调用
XACK显式确认,否则消息会一直留在PENDING列表里,下次XREADGROUP还会读到它 -
XREADGROUP的COUNT参数建议设为 1~10,避免单次拉取过多消息导致 OOM 或处理超时 - 使用
StringRedisTemplate时,XADD的ID必须传"*"字符串,不能传null,否则抛IllegalArgumentException - 消息体推荐用 JSON 字符串(而非 Java 对象序列化),避免不同服务间 class 版本不一致导致反序列化失败
示例片段(生产者):
stringRedisTemplate.opsForStream().add(
StreamRecords.newRecord()
.in("mystream")
.withFieldObject("event", "order_created")
.withFieldObject("order_id", "1001")
);
如何避免 Stream 的常见误用
Stream 功能强,但配置和使用稍复杂,几个关键点容易被忽略:
- 不要省略
MAXLEN ~限制:不加MAXLEN的Stream会无限增长,内存爆满或 RDB 备份变慢都是迟早的事 - 消费者组名不能含空格或特殊字符,否则
XGROUP命令解析失败;推荐纯小写字母+下划线,如order_group -
XREADGROUP的START参数用>表示“只读新消息”,用0表示“从头读”,别混淆;线上首次部署建议用> - 死信处理要自己实现:Redis 不提供自动死信队列,需监听
PENDING超时(比如 5 分钟未 ACK),再用XCLAIM抢回并转存到另一个dlq:stream - Spring Boot 的
@StreamListener已废弃,别在新项目里用;改用StreamMessageListenerContainer或自定义轮询逻辑
最易被忽略的一点:Stream 的消息 ID 是毫秒时间戳 + 序号,如果系统时间被回拨(如 NTP 校准异常),ID 可能乱序,导致 XREADGROUP 漏消息——务必确保 Redis 服务器时间稳定。


















