Přeskočit na obsah

Služba považuje kořenového klienta za otevřenou transakci a uloží pár záznamů zvlášť

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

Automatické pravidlo zakládalo úkol; každý úkol má svůj záznam v kalendáři. Při chybě databáze během vkládání úkolu zůstal v kalendáři uživatele záznam bez úkolu. Evidence kroků byla správně („úkol se nepodařil, vyřešte ručně“), ostatní akce pravidla proběhly, jen kalendář ukazoval něco, co neexistuje. Opakovaný běh obnovy osiřelý záznam neodstranil.

Služba měla atomicitu v kódu vyjádřenou, ale podmíněně:

export async function createTaskWithEvent(input: Input, db?: Tx) {
const run = async (tx: Tx) => {
const event = await tx.calendarEvent.create({ data: … });
return tx.task.create({ data: { …, calendarEventId: event.id } });
};
return db ? run(db) : prisma.$transaction(run); // „dostal jsem klienta = jsem v transakci“
}

Volající přitom předával kořenového klienta:

await executeAction(action, input, prisma as unknown as Tx); // jeden vstup
const db = opts.db ?? prisma; // druhý vstup: výchozí hodnota

Přetypování umlčelo kontrolu typů a služba vlastní transakci vynechala. Oba zápisy pak proběhly samostatně, každý se potvrdil hned. Volání úplně bez klienta (jiná cesta v aplikaci) fungovalo správně, proto vada nebyla vidět v běžných testech. Původní test navíc selhání vyvolával nahrazením celé služby, takže se mezi oba zápisy nikdy nedostal.

Služba rozliší skutečnou transakci podle klienta samotného, ne podle toho, že nějaký dostala:

const openTx = !!db && typeof (db as { $transaction?: unknown }).$transaction !== "function";
return openTx ? run(db!) : prisma.$transaction(run);
  • Klient interaktivní transakce nemá vlastní $transaction; kořenový klient ano, ať je přetypovaný jakkoli.
  • Skutečně předaná transakce se zachovává — o potvrzení a vrácení rozhoduje volající.
  • Oprava je ve službě, takže pokrývá oba chybné vstupy i každého budoucího volajícího. Volající se neměnil.
  • Vlastní transakce obsahuje jen oba zápisy; čtení nastavení zůstává před ní.

Dříve vzniklé osiřelé záznamy oprava nemaže — samostatný záznam v kalendáři může existovat i záměrně.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: grep na as unknown as u typu transakčního klienta a na vzor db ? run(db) : prisma.$transaction(run). U každého volitelného parametru klienta zjisti, co mu volající skutečně předávají, včetně výchozích hodnot typu opts.db ?? prisma.
  • Test: selhání vyvolej skutečnou chybou databáze až mezi oběma zápisy (dočasný trigger omezený na testovací data), ne nahrazením celé služby. Pokryj každý vstup zvlášť: kořenový klient, žádný klient, skutečná transakce s potvrzením, vrácením i poruchou uvnitř.
  • Kontrola dopadu: vedle počtu řádků ověř i to, co se měnit nemá — částky plateb a dokladů, navazující akce, stav evidence.
  • Anti-pattern: „klient v parametru = běžím v transakci“ a přetypování, které má jen uklidnit kompilátor.
  • Lepší přístup: kde to jde, mít pro transakci vlastní typ, který kořenový klient nesplní bez přetypování, a přetypování v kódu nedovolit.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz