ON CONFLICT s jedním cílem neochrání před druhým unikátním indexem
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Funkce „zajisti výchozí záznam“ je psaná jako souběhově bezpečná a má na to test (8 souběžných volání). Test roky
prochází, pak jednou v CI spadne na 23505 Key ("isDefault")=(t) already exists. Lokálně se to nepodaří vyvolat
ani ve stovkách kol.
Root cause
Sekce “Root cause”Tabulka má dva unikátní indexy, na kterých se dva souběžně vkládané „výchozí“ řádky střetnou: unikátní kód a částečný unikátní index „nejvýš jeden výchozí“.
INSERT INTO pipeline (id, code, is_default) VALUES (gen_random_uuid(), 'default', true)ON CONFLICT (code) DO NOTHING;Rozhodčím je jen index code. Když poražená transakce projde předběžnou kontrolou kódu dřív, než vítěz svůj řádek
zaindexuje (mikrosekundové okno), pokračuje ve vkládání a na druhém indexu už platí běžná kontrola unikátnosti:
počká na commit vítěze a skončí chybou.
Fix
Sekce “Fix”INSERT INTO pipeline (...) VALUES (...)ON CONFLICT DO NOTHING; -- bez cíle: rozhodčími jsou všechny unikátní indexyPo vložení se čte znovu a kontroluje se, že výsledný záznam existuje — chybějící je výslovná chyba aplikace. Jiné chyby databáze (cizí klíče, NOT NULL) se tím neskrývají.
Regresní test nečeká na náhodu: jiná transakce drží rozpracovaný řádek, který se s vkládaným střetne jen na
druhém indexu (jiný kód, stejný příznak). Volání se na ní zastaví (ověřuje se v pg_stat_activity,
wait_event_type = 'Lock'), pak transakce commitne nebo se vrátí zpět. Z pohledu vkládajícího příkazu je to stejná
cesta jako v souběhu — a na původním kódu selže vždy.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -n "ON CONFLICT ("a u každé tabulky zkontrolovat, kolik má unikátních indexů (i částečných). - Anti-pattern: souběhový test typu „spusť to 8× naráz“ jako jediný důkaz — okno bývá příliš úzké, test je zelený i nad chybou.
- Lepší přístup: rozhodčí = všechny indexy, nebo serializace advisory zámkem; test s řízeným konfliktem.
Sister bugs / související
Sekce “Sister bugs / související”- Čítač sekvence, který tiše ztrácí čísla (kategorie database).