Restart aplikace uprostřed cron jobu nechá RUNNING záznam a dispatcher job už nespustí
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nový job zrcadlení katalogu běžel každé 2 minuty a plnil tabulku. Po deployi (restart procesu přes PM2) se počet řádků přestal zvyšovat; rozvrh ukazoval nextRunAt v minulosti, dispatcher každou minutu hlásil ran: 0.
Root cause
Sekce “Root cause”Dispatcher před spuštěním jobu zapíše řádek běhu se stavem RUNNING a při dalším tiku job přeskočí, dokud existuje nedokončený běh. Restart procesu uprostřed běhu znamená, že finishedAt se nikdy nezapíše — zámek zůstane navždy. Čím delší joby (desítky sekund), tím pravděpodobnější kolize s deployem.
Fix
Sekce “Fix”Okamžitě: ručně uzavřít zámek a znovu naplánovat.
UPDATE "RunLog" SET status = 'ERROR', "finishedAt" = now() AT TIME ZONE 'utc', error = 'Přerušeno restartem aplikace' WHERE "jobKey" = '<job>' AND status = 'RUNNING';UPDATE "Schedule" SET "nextRunAt" = now() AT TIME ZONE 'utc' WHERE "jobKey" = '<job>';Pozor na časové zóny: aplikace ukládá UTC, now() v psql vrací lokální čas — nextRunAt = now() posune job o 2 hodiny do budoucna.
Trvale: dispatcher má RUNNING záznam starší než maxDuration + rezerva považovat za mrtvý (označit ERROR, pokračovat), nebo zámek ukládat s leaseUntil.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
SELECT * FROM run_log WHERE status='RUNNING' AND started_at < now() - interval '15 minutes'jako monitorovací dotaz po každém deployi. - Anti-pattern: booleovský zámek bez expirace; deploy skript, který restartuje bez čekání na doběhnutí jobů.
- Lepší přístup: lease s expirací; deploy skript před restartem počká na idle dispatcheru nebo joby navrhne tak, aby byly idempotentní a krátké (stav po každé stránce).
Sister bugs / související
Sekce “Sister bugs / související”- Časové zóny: rozvrh v UTC vs.
now()v lokální zóně databáze.