PostgreSQL timestamp bez pásma posune čas při kontrolním čtení přes node-pg
Symptom
Sekce “Symptom”Nezávislý test po opakované události hlásí změnu prvního času podpisu. Stav smlouvy je přitom správný a textové čtení hodnoty přímo v databázi ukazuje původní čas. Odchylka odpovídá místnímu posunu vůči UTC.
Root cause
Sekce “Root cause”Sloupec timestamp without time zone sám žádné pásmo nenese. Jedna aplikace používá konvenci UTC, zatímco výchozí parser klienta node-pg čte tento typ jako čas v pásmu procesu. Stejnou uloženou hodnotu proto dva klienti převedou na rozdílný okamžik.
Problém nebyl v opakované události ani v zápisu aplikace, ale v nezávislém auditním čtení. Bez rozlišení těchto vrstev by test vedl k neoprávněné opravě funkčního kódu.
Fix
Sekce “Fix”Nejdříve porovnej databázový text (hodnota::text), výsledek klienta (toISOString()) a smluvenou interpretaci aplikace. Pokud je pro daný sloupec prokázaná konvence UTC, nastav parser v izolovaném kontrolním procesu:
const { types } = require('pg');
// Pouze tam, kde je UTC konvence sloupce výslovně potvrzená.types.setTypeParser(1114, value => { return new Date(value.replace(' ', 'T') + 'Z');});Číslo 1114 je OID typu timestamp without time zone. Nastavení ovlivní všechny takové sloupce v daném procesu; neaplikuj je plošně tam, kde se ukládají místní kalendářové časy. Obecné řešení musí respektovat význam každého sloupce; změna schématu nebo převod historických dat není součástí opravy testu.
Po změně parseru zopakuj stejný pozitivní i odmítaný průchod a ověř, že se nezměnila uložená data aplikace. Neměň očekávaný čas jen proto, aby test prošel.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Při prvním testu přes jiného klienta přidej kontrolu známého okamžiku a porovnání s textovou hodnotou databáze; ověř zimní i letní offset.
- Anti-pattern: Porovnávat JavaScript Date ze dvou ovladačů bez ověření typu sloupce a časové konvence.
- Lepší přístup: Dokumentovat, zda pole reprezentuje okamžik nebo místní kalendářový čas, a podle toho sjednotit schéma a serializaci. Konkrétní parser používat pouze v kontrolovaném procesu.
Sister bugs / související
Sekce “Sister bugs / související”- Převod datumů přes
Date.toString()může přidat posun při exportu. - Pevný čas dne v testu může být už při spuštění v minulosti; tento problém parser časového pásma sám neřeší.
- Míchání
timestamp without time zoneatimestamptzvyžaduje explicitní význam hodnot, nikoli automatické připojování UTC ke všemu.