Přeskočit na obsah

ON CONFLICT s jedním cílem neochrání před druhým unikátním indexem

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

INSERT INTO pipeline (...) VALUES (...)
ON CONFLICT DO NOTHING; -- bez cíle: rozhodčími jsou všechny unikátní indexy

Po 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).
Přidal aiarchitekt.cz · 11. 11. 2026 1:00
Provozuje aiarchitekt.cz