Idempotentní seed hledá záznam podle „A nebo B“ a přepíše cizí záznam se stejným číslem
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Skript zakládající testovací účty pro každou roli měl u některých účtů vytvořit i evidenční záznam s pevným číslem. Při zkoušce nad databází, kde stejné číslo už měl jiný záznam, skript skončil s kódem 0 – a cizí záznam měl nové jméno, nový stav a byl přiřazený testovacímu účtu.
Root cause
Sekce “Root cause”„Idempotence“ byla udělaná takto:
const existing = await db.record.findFirst({ where: { OR: [{ user_id: user.id }, { number: wanted }] } });if (existing) await db.record.update({ where: { id: existing.id }, data: { ...testData, number: wanted } });else await db.record.create({ data: { ...testData, number: wanted } });Podmínka OR má zajistit, že opakované spuštění najde vlastní záznam. Stejně dobře ale najde cizí záznam se stejným číslem – a kód nerozlišuje, jestli nalezený záznam založil on sám. „Vyhrazené číslo“ bylo jen v komentáři.
Stejný vzor byl u účtů: upsert podle e-mailu přepsal heslo a role jakéhokoli účtu se shodnou adresou.
Dvě související pasti téže evidence:
- číslo je jedinečné i přes měkce smazané záznamy, takže „po testu smazat“ číslo neuvolní;
- další číslo se přiděluje jako
max + 1, takže testovací záznam s vysokým číslem posune číslování všem dalším skutečným záznamům.
Fix
Sekce “Fix”- Důkaz původu: každý záznam založený seedem dostane auditní značku (akce + typ + ID). Seed mění jen záznamy s touto značkou.
- Ověření předem: před prvním zápisem projdi všechny cíle a posbírej kolize – cizí účet s e-mailem, cizí (i smazaný) záznam s číslem, nesouhlasící vazba, chybějící číselník. Při jakékoli kolizi skonči chybou a vypiš všechny důvody.
- Jedna transakce pro všechny zápisy, aby pád uprostřed nenechal polovinu.
- Čísla bez výchozí hodnoty – zadává je člověk po ověření proti skutečným datům.
Druhé kolo – kontrola musí platit i v okamžiku zápisu. Ověření předem uvnitř transakce nestačí: při výchozí izolaci (READ COMMITTED) je to obyčejné čtení a jiná transakce může vazbu změnit mezi kontrolou a zápisem. Starý plán ji pak tiše přepíše. Správné pořadí:
- úvodní čtení jen k určení, co zamknout;
- zámky dotčených existujících záznamů – stejné poradní zámky a pořadí jako aplikace a navíc
SELECT … FOR UPDATE(blokuje i přímý zápis mimo aplikaci); - nové čtení a rozhodnutí až po zámcích; záznam, který se objevil mezi čtením a zámky, je konflikt;
- zápis existujícího záznamu podmíněný stavem, podle kterého se rozhodlo (
updateMany … where+ kontrola počtu).
Souběh se testuje ve dvou skutečných transakcích a v obou pořadích: změna potvrzená před zámky = konflikt; změna zahájená během zápisů čeká na dokončení a potom se provede (ověřit bariérou s časovým limitem, ne vynuceným selháním).
Testy: opakování vlastních záznamů, cizí číslo, smazaný cizí záznam s číslem, cizí e-mail, nesouhlasící vazba, chybějící číselník, pád uprostřed zápisů. Ověř mutací (vrať chybnou podmínku), že testy opravdu selžou.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "OR: \[" prisma/ scripts/a hledejfindFirstnásledovanýupdate; každýupsertv seedu podle přirozeného klíče (e-mail, číslo, název). - Anti-pattern: považovat „najdu-li, aktualizuji“ za bezpečnou idempotenci; spoléhat na rezervaci v komentáři; ověřovat seed jen na prázdné databázi.
- Lepší přístup: seed spouštěný mimo čistě vývojovou databázi ber jako migraci dat – s ověřením předem, konfliktem místo přepisu a zkouškou nad databází, kde cíle už někomu patří.
Sister bugs / související
Sekce “Sister bugs / související”- Test počítá všechny záznamy ve sdílené databázi a závisí na datu – další případ, kdy kód předpokládá, že v databázi jsou jen jeho vlastní data.