Node.js 定时任务多实例重复推送:我用 Redis 锁、租约和幂等标记收口
一次订阅通知重复推送让我意识到:多实例下的 cron 不能只靠进程内锁。本文记录用 Redis 分布式锁、租约续期和幂等标记收口的过程。

作者
ZHOUYI
晚上十点,小程序订阅通知忽然每个用户收到两条,后台投诉一下子冒出来。排查后发现,服务从单实例扩到三实例后,Node 里的定时任务每个实例都到点触发,大家都在抢同一次推送。
为什么进程内锁不够
- 进程内锁只能挡住同一个实例里的并发,挡不住多实例同时抢跑。
- 如果任务执行变慢,固定超时的锁可能提前释放,第二个实例会误以为没人执行。
- 只靠日志很难判断重复来源,最好把重复消费挡在业务层。
一开始我想给每个实例加随机延迟,但这只是碰运气。真正要解决的是:同一批业务在同一时间窗口内只能有一个执行者,并且执行结果不能重复产生副作用。
Redis 分布式锁 + 租约续期
我用 Redis 的 SET key token NX PX ttl 抢锁,只有拿到锁的实例才执行任务。任务没跑完时,由后台定时器带着 token 续期;一旦续期失败,说明锁已经不属于自己,就停止继续写数据。
const token = Math.random().toString(36).slice(2);
const ok = await redis.set(key, token, 'PX', ttl, 'NX');
if (!ok) return;
const renewLua = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('pexpire', KEYS[1], ARGV[2]) else return 0 end";
const lease = setInterval(async () => {
if (!await redis.eval(renewLua, 1, key, token, ttl)) clearInterval(lease);
}, ttl / 3);
try { await job(); } finally {
const delLua = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end";
await redis.eval(delLua, 1, key, token);
clearInterval(lease);
}租约间隔不要设得太激进,一般取锁超时的三分之一。如果任务本身可以拆分,最好按日期或用户分片,把锁粒度做小,避免一个实例卡住影响整体。
踩过的坑是释放锁不能直接 DEL,否则 A 实例慢一点,可能把 B 实例刚拿到的锁删掉。续期和释放都要带 token 校验;如果任务会调用第三方推送,最好把业务日期和用户 ID 组成唯一请求标记,方便事后对账。
幂等标记才是底线
锁只是降低重复概率,不是业务正确性保证。真正推送前,我会写一条幂等记录,例如 push:{date}:{userId},并在 MongoDB 里建唯一索引。即使锁提前过期、两个实例都进入任务,第二个写入会冲突,通知也不会重复发。
“小结:多实例定时任务,不要只相信 cron。分布式锁负责让大多数情况只有一个实例抢跑,租约续期避免任务没完锁先过期,幂等标记负责最后兜底。”