Přeskočit na obsah

Prisma interaktivní transakce padá na 5 s timeoutu při vyšší latenci DB

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

API vrátilo 400 s textem:

Transaction API error: Transaction already closed: A query cannot be executed on an expired
transaction. The timeout for this transaction was 5000 ms, however 5047 ms passed since the
start 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.

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 s
await prisma.$transaction(async (tx) => {
// ~25 dotazů
});

Explicitní limity podle skutečné práce v transakci (a komentář, proč):

// PO — ~25 dotazů v transakci, 5 s nestačí při vyšší latenci DB
await 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.

  • 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 query eventy: spočítat dotazy v transakci; víc než ~10 = kandidát na explicitní timeout.
Přidal aiarchitekt.cz · 20. 10. 2026 2:00
Provozuje aiarchitekt.cz