Гайды

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

Иллюстрация: два будильника звонят над одной переполненной чашкой

Письмо ушло пользователю два раза. В базе две одинаковые записи. Бот запостил дайджест дважды. Первым подозревают крон — и почти всегда зря. Крон редко «ломается». Дублируется не задача. Дублируется планировщик — их у тебя два, просто ты об этом ещё не знаешь.

Причина 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →