Почему задача по расписанию выполняется дважды — три причины и лечение

Письмо ушло пользователю два раза. В базе две одинаковые записи. Бот запостил дайджест дважды. Первым подозревают крон — и почти всегда зря. Крон редко «ломается». Дублируется не задача. Дублируется планировщик — их у тебя два, просто ты об этом ещё не знаешь.
Причина 1: планировщиков два
Самая частая причина. Расписание живёт внутри приложения — а приложение запущено в двух местах:
- локально на ноуте И на сервере — ты забыл остановить дев-версию;
- старый процесс пережил деплой, и рядом крутится новый;
- процесс-менеджер запускает несколько копий (кластерный режим PM2 — это N воркеров, и каждый заводит свой крон).
Каждая копия честно срабатывает по расписанию. Две копии — два письма.
Отдельно коварен второй пункт. Деплой «без простоя» устроен так: платформа поднимает новую версию, убеждается, что она жива, и только потом гасит старую. Несколько минут работают обе — и если тик расписания попал в это окно, задача выполнится дважды. Дубли «только иногда, после релиза» — почти всегда он.
Как проверить. Добавь в задачу одну строку лога: имя машины и id процесса.
console.log('digest start', process.pid, os.hostname());
Увидел в логах два разных pid или hostname — диагноз готов.
Как починить. Планировщик должен жить в одном экземпляре. Самый надёжный ход — вынести расписание из приложения: пусть внешний крон или планировщик хостинга дёргает один HTTP-эндпоинт. Копий приложения может быть сколько угодно — звонок будет один.
Причина 2: задача бежит дольше интервала
Тик каждые 5 минут, а задача занимает 7. Новый запуск стартует, пока старый ещё работает. Обработка идёт по тем же данным — со стороны выглядит как дубль.
Как проверить. Логируй начало и конец с временем. Если «start» приходит раньше, чем «end» предыдущего, — вот оно.
Как починить. Замок: флаг «уже бегу».
let running = false;
async function tick() {
if (running) return;
running = true;
try { await doWork(); } finally { running = false; }
}
Для shell-крона то же самое делает flock. А ещё проще — планировать следующий запуск только после конца текущего: цикл с паузой вместо жёсткого тика.
Причина 3: ретрай добивает после падения
Задача упала посередине: письмо уже ушло, а отметка «отправлено» записаться не успела. Система повторила задачу — письмо ушло второй раз.
Это не экзотика, а норма: очереди и вебхуки специально доставляют «минимум один раз» — недоставка для них хуже дубля. Вебхуки повторяются, пока не получат ответ 200, — та же логика.
Как проверить. Ищи в логах ошибку между действием и отметкой о нём.
Как починить. Идемпотентность: сначала проверь «уже сделано?», потом делай. Самый крепкий вариант — уникальный ключ в базе:
CREATE UNIQUE INDEX one_digest_per_day
ON digests (user_id, digest_date);
INSERT INTO digests (user_id, digest_date)
VALUES (42, '2026-08-16')
ON CONFLICT DO NOTHING; -- повтор тихо не пройдёт
Вторая вставка упрётся в уникальность — и это хорошо: база не даст задублировать, даже когда код ошибётся. Отправляй письмо только после успешной вставки.
Как больше не ловить это
- Одна строка лога на каждый запуск: hostname, pid, время начала и конца.
- Побочные эффекты — под уникальным ключом в базе.
- Планировщик не стартует без флага: проверяй переменную окружения и включай его только в production — дев-копия на ноуте перестанет слать письма.
- Расписание — в одном месте, и настроено осознанно, а не «где-то в коде».
Почему на ноуте всё нормально, а на сервере дубли?
На ноуте одна копия процесса. На сервере — реплики, пережившие деплой процессы или твой же ноут, продолжающий работать параллельно с продом.
Бывают ли дубли из-за перевода часов?
Да, редкий случай: при переводе стрелок час 02:00 случается дважды (или не случается вовсе). Для критичных задач ставь расписание в UTC — там таких сюрпризов нет.
А если задача, наоборот, не срабатывает вообще?
Это соседний диагноз со своими причинами — разбираем его отдельно в статье почему крон-задача не запускается.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





