Pravidelný úklid smaže dočasné varianty souboru, který se právě nahrává
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nahrání obrázku občas skončí chybou ENOENT při přesunu náhledu z dočasného adresáře, přestože uživatel má oprávnění, soubor je platný a nic jiného se záznamem neděje. Chyba se objevuje nárazově – jen když do nahrávání „trefí“ pravidelná úloha.
Root cause
Sekce “Root cause”Upload běží ve fázích: záznam „rozpracováno“ → dočasné soubory (originál + náhledy) → přesun → záznam „hotovo“ včetně seznamu náhledů. Úklid osiřelých dočasných souborů si sestaví množinu známých klíčů z databáze:
known.add(row.storageKey);for (const v of row.variants) known.add(v.key); // u rozpracovaného uploadu ještě prázdnéOriginál rozpracovaného uploadu v množině je, jeho náhledy ne – úklid je smaže jako sirotky. Druhá díra je pořadí: množina se načte před výpisem dočasného adresáře, takže upload, který své záznamy potvrdí mezi oběma kroky, je celý „neznámý“.
Fix
Sekce “Fix”- Dočasný soubor patří živé operaci, pokud existuje nesmazaný záznam se stejným základem klíče (klíč bez přípony a bez přípony varianty) – chrání originál i všechny náhledy.
- Pořadí: nejdřív vypsat dočasné soubory, potom číst živé záznamy. Upload zapisuje soubory až po potvrzení záznamu, takže každý vypsaný soubor už záznam má; co vznikne během scanu, ve výpisu není.
- Konečné rozhodnutí znovu z databáze a u existujícího záznamu pod jeho zámkem.
- Stáří souboru nepoužívat jako jedinou ochranu – platný upload může trvat až do svého časového limitu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: test, který upload zastaví po zápisu dočasných souborů, pustí skutečný úklid a upload nechá doběhnout; zopakovat pro každý typ entity, pro více souběžných uploadů a pro úklid spuštěný jen nad částí dat.
- Anti-pattern: „co není v databázi, je sirotek“ u dat, která se do databáze zapisují až na konci operace.
- Lepší přístup: jmenný prostor operace (společný prefix) nebo manifest zapsaný v první fázi; úklid a operace sdílejí zámek.
Sister bugs / související
Sekce “Sister bugs / související”Vícefázový upload – cizí úklid smaže rozpracovaná data a pozdní fáze spadne chybou úložiště; vícefázový upload ověří oprávnění jen před první fází.