Stav „soubor chybí“ zaměněný za potvrzené fyzické smazání
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Retence nebo výmaz na žádost hlásí hotovo, databáze je očištěná a soubory nejsou přes aplikaci dostupné – ale na disku dál leží. Dvě podoby:
- Záznam byl už dřív označen „soubor chybí“ (ztratil se originál); jeho náhledy existují dál a retence je přeskočí.
- Úložiště mazání odmítne (oprávnění, chyba disku); úklid chybu spolkne, záznam se označí jako vyřízený a další běh ho už nevybere.
Root cause
Sekce “Root cause”Jeden stav nese dva významy:
await deleteFiles(media).catch(() => undefined); // spolkne i EACCES / EIOawait db.media.update({ where: { id }, data: { state: "missing" } }); // „chybí“ = „smazáno“?// …a výběr kandidátů: state != "missing"„Chybí originál“ je pozorování o jednom souboru. „Vše fyzicky odstraněno“ je potvrzení o celé sadě (originál, odvozené varianty, dočasné kopie). Když se zaměňují, úspěšné i neúspěšné mazání vypadají stejně a zbytky zmizí z dohledu.
Fix
Sekce “Fix”- Samostatný příznak (čas ověřeného odstranění), zapisovaný až po kontrole, že v cílovém ani dočasném adresáři nezbyl žádný soubor odvozený z klíče.
- Přísné mazání:
ENOENTje v pořádku (idempotence), cokoli jiného se propaguje s kódem chyby. - Kandidáti úklidu = smazané záznamy bez potvrzení, bez ohledu na stav „chybí“.
- Chyba jednoho souboru nezastaví ostatní; nepotvrzené zůstávají kandidátem a jsou vidět (hlášení úlohy, log s kódem chyby, počitadlo v administraci).
- Technické záznamy nedokončené operace mazat až po ověřeném smazání jejích souborů – jinak zůstanou soubory bez záznamu, podle kterého by šly najít.
- Výpis adresáře, který při chybě čtení vrátí „prázdno“, je stejná past o úroveň níž.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej
.catch(() => undefined)aforce: truekolem mazání následované zápisem „hotovo“; test s vloženou chybou úložiště a test „originál pryč, náhledy zůstaly“. - Anti-pattern: úklid nejlepší snahou použitý tam, kde se výsledek někomu slibuje (retence, výmaz osobních údajů).
- Lepší přístup: dvě funkce – úklid nejlepší snahou pro chybové větve a přísné mazání s potvrzením pro retenci; opakovatelnost řízená příznakem, ne stavem.
Sister bugs / související
Sekce “Sister bugs / související”Časově omezený obsah na cachované stránce zůstane vidět po konci platnosti; úklid testu smaže řádek, ale nechá job ve frontě.