RDelayedQueue是当前Spring Boot项目中最稳妥的分布式延时任务方案，因其封装ZSet+List自动实现任务排序、原子转移、持久化保障与并发安全，避免手写轮询的休眠策略、幂等、丢任务等边界问题。
RDelayedQueue 是当前 Spring Boot 项目里最稳妥的分布式延时任务队列方案，不用自己拼 ZADD + ZRANGEBYSCORE 轮询逻辑，也不依赖 RabbitMQ 等中间件。
为什么别手写 ZSet 轮询逻辑
手写基于 Redis ZSet 的延迟队列看似简单，但实际要兜住一堆边界问题：
-
ZRANGEBYSCORE返回空时要不要Thread.sleep()？休眠多久才不拖垮 Redis？ - 多个实例并发拉取同一任务，怎么加锁又不卡死？
- 任务被重复消费了怎么幂等？比如订单已取消，又被二次触发关单。
- Redis 故障期间新入队任务是否丢失？恢复后会不会集中爆发？
- 扫描间隔设成 100ms 还是 1s？精度和 QPS 怎么权衡？
这些问题 RDelayedQueue 全部封装好了：底层用 ZSet 存时间戳 + List 做中转，自动原子转移、失败重试、监听回调，还支持集群节点切换。
Spring Boot 集成 Redisson 的三个硬性步骤
漏掉任意一步，RDelayedQueue 就只是个不能消费的空壳：
- 必须用
redisson-spring-boot-starter（推荐 3.23.0+），redisson单独依赖不行；低版本如 3.15.4 在 Spring Boot 3.2+ 上有兼容问题。 -
RedissonConfig中不能只配singleServerConfig；集群环境必须用clusterServersConfig，否则节点故障时任务静默丢弃。 - 消费端必须显式调用
addDelayedQueue()并start()监听器——它不会像@Scheduled那样自动触发。
入队时必须带完整业务上下文
很多人只传 orderId，结果超时消费时查不到订单状态。根本原因是：RDelayedQueue 只管“什么时候触发”，不管“触发时要干什么”。
正确做法是把必要字段序列化进任务对象：
OrderDelayTask task = new OrderDelayTask(orderId, userId, expireAt); delayedQueue.offer(task, 30, TimeUnit.MINUTES);
而不是：
delayedQueue.offer(orderId, 30, TimeUnit.MINUTES);
否则消费反序列化后只剩 ID，再去 DB 查可能已被更新、删除或状态不一致。
精度、TTL 和兜底补偿的真实代价
RDelayedQueue 默认精度是秒级（pollInterval=1000ms）。想提至 500ms，实测 10 万订单/分钟场景下 Redis CPU 占用从 15% 升至 35%。
另一个常被忽略的点是没设 TTL：Redis 挂 1 小时再恢复，积压任务会瞬间涌出。建议：
- 业务层加校验：
task.createTime ≤ System.currentTimeMillis() + maxAllowedDelay； - 搭配
RScheduledExecutorService做兜底补偿，比如每 5 分钟扫一次“已超时但未执行”的任务。
真正需要亚秒级响应的场景（如支付倒计时弹窗），应该由前端定时器驱动 + 后端异步兜底，而不是强求 Redis 队列毫秒精度。
