Regenerace PDF cache smazala nahraný podepsaný dokument
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Uživatelé hlásili „zmizely všechny PDF smluv“. U smluv, kde byl ručně nahraný podepsaný originál (sken), se po čase v náhledu objevilo nepodepsané PDF vygenerované ze šablony. V jednom případě byl soubor originálu smazaný z disku minutu po nahrání.
Root cause
Sekce “Root cause”Model smlouvy měl jedno pole pdfUrl, do kterého se ukládala jak cesta k vygenerované cache (pdf-cache/<id>-<ts>.pdf), tak cesta k nahranému podepsanému originálu (signed/<uuid>.pdf). Dvě nezávislé větve s tím zacházely jako s cache:
// regenerace po PUT záznamu — „starý soubor“ = cokoliv v pdfUrlif (contract.pdfUrl) await deleteStoredFile(contract.pdfUrl); // smaže i podepsaný originálcontract.pdfUrl = writeCache(...);
// invalidace po úpravě nadřazeného záznamu (klient)await db.contract.updateMany({ where: { clientId, NOT: { pdfUrl: { contains: "/signed_" } } }, // chrání jen formát z e-podpisu data: { pdfUrl: null }, // ručně nahraný „signed/uuid.pdf“ neprojde});Ochranný test znal jen jeden ze dvou formátů cest (/signed_ z integrace e-podpisu), ručně nahrané originály (signed/<uuid>.pdf) neodchytil. Po vynulování odkazu se při dalším náhledu vygenerovalo nepodepsané PDF; po PUT záznamu se originál i fyzicky smazal.
Fix
Sekce “Fix”export function isSignedPath(p?: string | null) { return !!p && (p.includes("signed/") || p.includes("/signed_"));}// regenerace: podepsaný dokument se NEpřegenerovává, vrací se beze změnyif (isSignedPath(contract.pdfUrl)) return readStored(contract.pdfUrl);// mazat jen cacheif (contract.pdfUrl?.includes("pdf-cache/") && !isSignedPath(contract.pdfUrl)) await deleteStoredFile(contract.pdfUrl);// invalidace: podepsané záznamy vůbec nevybíratwhere: { clientId, signedAt: null, NOT: [{ pdfUrl: { contains: "/signed_" } }, { pdfUrl: { contains: "signed/" } }] }Obnova: originály na disku zůstaly (jen odkaz byl pryč) — spárovaly se podle času podpisu v DB = mtime souboru (±5 s); jeden soubor smazaný před nočním zálohováním se obnovit nedal.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -n "deleteStoredFile\|unlink"u polí, která mohou nést nahraný soubor; SQL: záznamy sesignedAt IS NOT NULLapdfUrl LIKE 'pdf-cache/%'= podepsané záznamy servírující cache. - Anti-pattern: jedno pole pro cache i originál; ochranný test podle jednoho konkrétního prefixu názvu souboru; „smaž starý soubor a přepiš“ bez rozlišení původu.
- Lepší přístup: samostatné pole
signedPdfUrl(immutable, nikdy nemazané), cache vpdfCacheUrl; mazací helper, který smaže jen cesty pod cache adresářem; nahrané originály verzovat, ne přepisovat; zálohu uploadů častěji než 1× denně (nebo write-ahead kopie při nahrání).
Sister bugs / související
Sekce “Sister bugs / související”- Invalidace cache spouštěná „přítomností pole v payloadu“ místo skutečné změny hodnoty → každé uložení formuláře invaliduje vše.