Prisma interaktivní transakce padá na 5 s timeoutu při vyšší latenci DB
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”API vrátilo 400 s textem:
Transaction API error: Transaction already closed: A query cannot be executed on an expiredtransaction. The timeout for this transaction was 5000 ms, however 5047 ms passed since thestart of the transaction.Integrační testy nad lokální DB prošly (celá transakce ~300 ms). Chyba se objevila až při E2E proti databázi za SSH tunelem, kde má každý dotaz ~150–200 ms round-trip. Transakce se korektně odrolovala (žádná částečná data), ale uživatel dostal chybu a musel akci opakovat.
Root cause
Sekce “Root cause”prisma.$transaction(async (tx) => { … }) má výchozí timeout: 5000 a maxWait: 2000. Pokud se do transakce postupně přidávají kroky (poznámka → aktivita → událost v kalendáři → follow-up → aktualizace leadu → historie…), snadno vznikne 20–30 sekvenčních dotazů. Lokálně je to pod sekundu; s latencí 200 ms na dotaz je to přes 5 s. Limit se neprojeví na začátku, ale až na dotazu, který „přeteče“ — typicky poslední create logovacího záznamu.
// PŘED — výchozí 5 sawait prisma.$transaction(async (tx) => { // ~25 dotazů});Fix
Sekce “Fix”Explicitní limity podle skutečné práce v transakci (a komentář, proč):
// PO — ~25 dotazů v transakci, 5 s nestačí při vyšší latenci DBawait prisma.$transaction(async (tx) => { // ~25 dotazů}, { timeout: 20_000, maxWait: 10_000 });Dlouhodobě: zkrátit transakci (předpočítat vstupy mimo ni, konfigurace načíst jednou místo v každém pomocném volání) a notifikace/e-maily posílat až po commitu.
Jak to odhalit dřív
Sekce “Jak to odhalit dřív”- Integrační testy běží nad lokální DB → latenci neukážou. Minimálně jeden E2E běh proti vzdálené DB (tunel) nebo umělé zpoždění v test DB.
- Log Prismy s
queryeventy: spočítat dotazy v transakci; víc než ~10 = kandidát na explicitní timeout.