Go无原生DelayQueue,需自建可靠延迟队列;常用方案为Redis ZSET轮询、MySQL时间字段加锁、RabbitMQ TTL+死信;time.AfterFunc仅适用于轻量、可丢失、短时本地任务。

延迟消息在 Go 里没有原生 DelayQueue,得自己搭
Go 标准库不提供类似 Java DelayQueue 或 Redis 的 ZSET 延迟队列抽象,直接用 time.AfterFunc 或 time.Ticker 只适合单机、轻量、短生命周期的定时任务——一旦进程重启,所有未触发任务就丢了。真要落地业务(比如订单超时关单、消息重试、预约通知),必须依赖外部存储或自建可靠调度层。
常见做法有三类:Redis ZSET + 定时轮询、MySQL 时间字段 + 悲观/乐观锁、RabbitMQ TTL + 死信交换机。选型关键看吞吐、一致性要求和运维成本:
-
Redis最常用:用ZADD order_delay 1718923456000 order:123存时间戳为 score,后台 goroutine 每 100msZRANGEBYSCORE拉一批 WATCH + MULTI 或 Lua 脚本保证“拉取+删除”原子性,否则重复消费 -
MySQL更稳妥:加delay_at DATETIME和status TINYINT字段,用SELECT ... FOR UPDATE SKIP LOCKED避免并发抢同一行;缺点是高频轮询影响数据库压力,建议加delay_at > NOW() - INTERVAL 1 MINUTE过滤无效扫描 -
RabbitMQ适合已用该中间件的场景:发消息时设expiration(毫秒),绑定死信 Exchange,由消费者监听死信队列;但注意expiration是发送时静态设定,无法动态调整延迟时间
用 time.AfterFunc 做本地延迟,只适用于非关键路径
它本质是往 runtime.timer 堆注册一个回调,轻量、无依赖,但有硬伤:进程挂了就全丢,且无法取消已注册但未触发的任务(time.AfterFunc 返回值是 void)。
如果非要临时用,务必满足三个条件:
立即学习“go语言免费学习笔记(深入)”;
- 任务失败可接受(比如发个非核心埋点)
- 延迟时间短(
- 调用前做防御判断:
if delay ,否则 <code>time.AfterFunc会立刻触发,容易引发意料外执行
示例:
delay := time.Until(time.Now().Add(5 * time.Second))
if delay > 0 {
time.AfterFunc(delay, func() {
processOrder(orderID)
})
}
Redis ZSET 实现里,score 必须用毫秒时间戳,别用秒
因为 ZRANGEBYSCORE 的精度只到整数,如果存秒级时间戳(如 1718923456),多个任务在同一秒内触发时,拉取逻辑可能一次扫出几百条,又没做分页,导致单次处理过载甚至 OOM。
Go 配置库,使用 spf13/viper — 分层优先级(flag > env >file > KV > default),提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
正确做法是统一用毫秒时间戳作为 score:
- 写入:
ZADD my_delay_queue 1718923456789 "task:abc" - 拉取:
ZRANGEBYSCORE my_delay_queue -inf 1718923456789 LIMIT 0 100,再用ZREM批量删除已取任务 - 务必在 Lua 脚本里完成“读+删”,否则并发时 A 读到任务、B 也读到、A 处理完 B 又处理,重复执行
别用 EXPIRE 给 key 加过期——ZSET 本身不支持 key 级 TTL,且任务时间跨度大时,key 长期存在没问题,重点是 score 索引是否准确。
MySQL 方案中,SELECT FOR UPDATE 不加 SKIP LOCKED 会阻塞
老式写法 SELECT ... FOR UPDATE 在高并发下容易让后续查询排队等待,尤其当某条记录被长时间持有锁(比如处理函数卡住),整个延迟队列就堵死。
MySQL 8.0+ 必须启用 SKIP LOCKED:
SELECT id, payload FROM delay_tasks WHERE status = 0 AND delay_at <= NOW() ORDER BY delay_at LIMIT 20 FOR UPDATE SKIP LOCKED;
这样每个 worker 拿到互斥子集,不会争同一行。同时注意:
- 给
delay_at和status建联合索引:INDEX idx_delay_status (delay_at, status),否则全表扫描 - 更新状态时用
UPDATE ... WHERE id IN (...) AND status = 0,防止其他协程已处理却覆盖成功标记 - 任务处理失败要回滚状态,不能留
status = 1却没执行,否则永远进不了下一轮扫描
真正难的不是怎么查,是怎么让“查-改-执行”这三步在分布式环境下不丢、不重、不乱序。每个环节都要加幂等键、失败重试、死信兜底——这些细节比选什么技术栈更决定上线后能不能睡安稳觉。

















