Jeden sloupec času zapisují dvě konvence — ORM v UTC a raw SQL now() v čase relace
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Fronta událostí dává čerstvému záznamu desetiminutový odklad, aby ho stihl dokončit požadavek, který ho založil. V databázi s relací v pásmu UTC to fungovalo. V relaci o hodinu na východ plánovaná úloha čerstvý záznam převzala a provedla hned — podle databáze byl „50 minut po lhůtě“. V relaci na západ od UTC se naopak odklad prodloužil o několik hodin. Čekání po chybě a ostatní lhůty přitom fungovaly ve všech pásmech správně.
Root cause
Sekce “Root cause”Sloupec je timestamp without time zone. Zapisovalo do něj sedm míst a jen jedno jinak než ostatní:
// čerstvý záznam — ORM, hodnota z hodin aplikace → uloží se UTC bez pásmaawait db.event.createMany({ data: [{ …, nextAttemptAt: new Date(Date.now() + 10 * 60_000) }] });-- ostatní zápisy a všechna čtení — raw SQL, místní čas relaceUPDATE "Event" SET "nextAttemptAt" = now() + interval '1 hour' WHERE …;SELECT … FROM "Event" WHERE "nextAttemptAt" <= now();now() je timestamptz; při zápisu do sloupce bez pásma i při porovnání s ním PostgreSQL použije pásmo relace. Šest zapisovatelů a všichni čtenáři si proto rozuměli. Hodnota od ORM byla proti nim posunutá přesně o posun relace od UTC.
Vadu neodhalí testy, které lhůty „posouvají do minulosti“ pomocným příkazem (ten zapíše now() a rozdíl konvencí zakryje), ani běh v databázi s relací v UTC.
Fix
Sekce “Fix”Opraven byl zapisovatel, který se lišil. Čas čerstvého záznamu určují hodiny databáze a zapíše se ve stejné podobě jako u ostatních:
const [{ at }] = await db.$queryRaw<{ at: Date }[]>` SELECT (clock_timestamp() + make_interval(mins => ${minutes}::int))::timestamp AS at`;await db.event.createMany({ data: [{ …, nextAttemptAt: at }] });clock_timestamp()je okamžik zápisu;now()by uvnitř delší transakce znamenalo její začátek.- Odklad se přičítá před převodem na místní čas bez pásma.
- Dotaz jde stejným klientem jako INSERT (stejná transakce), nečte žádnou tabulku a nebere zámky.
- Čtení a ostatní zapisovatelé se nezměnili, takže se nezměnilo čekání po chybě ani už uložené řádky.
Zvažovaná opačná oprava — převést čtení na UTC — by čerstvý záznam také opravila, ale všechny řádky od ostatních zapisovatelů by posunula o pásmo relace (čekání po chybě delší o hodinu či dvě, „splatné hned“ by hodinu čekalo), včetně rozpracovaných řádků z doby před nasazením. Dala by se udělat jen jako sjednocení celého sloupce: všechny zápisy i čtení najednou.
Stav je záměrně jen „zmírněno“: sloupec se dál vede v místním čase bez pásma. Při podzimní změně času je hodina, která nastane dvakrát, nejednoznačná — termín, který padne do jejího prvního výskytu, se přečte o hodinu později. Stejně tak by vadila změna pásma relace mezi zápisem a čtením.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: najdi sloupce
timestampbez pásma, do kterých zapisuje ORM i raw SQL snow()/CURRENT_TIMESTAMPnebo s přetypováním::timestamp. Stejný sloupec + dvě cesty zápisu = podezření. - Mapa před opravou: vypiš zapisovatele (kdo, jakou hodnotu, z jakých hodin) a čtenáře (s čím porovnávají). Většinová konvence určuje, co je „správně“ pro uložená data.
- Měření: zeptej se databáze na zbývající čas tak, jak ho vidí čtecí podmínka (
sloupec - now()), hned po zápisu a bez úprav. Opakuj v relaci UTC, s kladným i záporným posunem. - Test: čerstvý záznam ze skutečné cesty a úloha spuštěná jako plánovač, bez pomocného „posunu lhůt“. Pozitivní kontrolu po lhůtě dělej posunem uloženého času přesně o délku odkladu a výslovně ji označ; skutečné uplynutí lhůty ověř zvlášť mimo sadu.
- Anti-pattern: opravit jedno porovnání podle vzoru z jiného sloupce, aniž víš, kdo do tohoto sloupce zapisuje.
- Lepší přístup pro nové tabulky:
timestamptz, nebo jediná funkce, přes kterou čas do sloupce zapisují všichni.
Sister bugs / související
Sekce “Sister bugs / související”- UTC čas bez pásma v SQL porovnání přebere pásmo relace — tam všichni zapisovali v UTC a chybné bylo čtení; tady je to naopak, proto je i oprava na opačné straně.
- Dávková úloha s limitem před filtrem — starší nezpracovatelné položky trvale blokují ty za nimi — jiná vada téže fronty.
- PostgreSQL timestamp bez pásma posune čas při kontrolním čtení přes node-pg