Měkké smazání nechá veřejný soubor dostupný – vydává ho proxy přímo z disku
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Při ověřování nahrávání jsem zkušební soubor v knihovně médií smazal a jeho veřejná adresa dál vracela 200. Platilo to pro všechny dříve smazané soubory – v administraci zmizely, v evidenci byly „smazané“, ale kdo znal adresu, stáhl je.
Root cause
Sekce “Root cause”Aplikace mazala měkce – jen řádek:
export async function softDeleteMedia(id: string, reason: string) { return db.media.update({ where: { id }, data: { deleted_at: new Date(), deleted_reason: reason } });}Všechny cesty aplikace deleted_at respektovaly. Veřejné soubory ale kvůli rychlosti vydává reverzní proxy přímo ze složky na disku a aplikace se k požadavku vůbec nedostane:
handle_path /uploads/* { root * <kořen-úložiště>/public file_server}Příznak v databázi tak na výdej neměl žádný vliv. Automatické testy to neodhalily: po smazání ověřovaly jen odpověď mazacího API, ne původní adresu souboru.
Fix
Sekce “Fix”Smazání veřejného souboru ho zároveň přesune z veřejného umístění do neveřejného (originál i odvozené varianty). Nic se nemaže, měkké smazání zůstává vratné:
// pod zámkem záznamu, po novém přečtení stavu z databázeconst media = await tx.media.update({ where: { id }, data: { deleted_at: new Date(), deleted_reason: reason } });if (media.visibility === "public") { for (const key of keysOf(media)) if (await store.existsStrict("public", key)) await store.moveStrict(key, "public", "private"); for (const key of keysOf(media)) if (await store.existsStrict("public", key)) throw new Error("soubor zůstal veřejný"); await tx.media.update({ where: { id }, data: { visibility: "private" } }); // až po ověření}- Pořadí odolné proti pádu: nejdřív příznak smazání, potom přesun; stav „skryto“ se zapíše až po ověření.
- Periodický úklid bere záznamy „smazané a stále vedené jako veřejné“ – dorovná soubory smazané před opravou i přesun přerušený uprostřed – a hlásí počet neúspěchů.
- Regresní test po smazání požádá o původní veřejnou adresu a čeká 404.
Tři chyby v první verzi opravy (našel je nezávislý auditor)
Sekce “Tři chyby v první verzi opravy (našel je nezávislý auditor)”- Chyba čtení disku brána jako „soubor tam není“. Pomocná funkce
exists()vracelafalsepři jakékoli chyběstat, tedy i při odepřeném přístupu. Nedostupné úložiště tak „potvrdilo“ skrytí, záznam se přepnul na neveřejný a úklid ho už nikdy nevybral – po obnově úložiště byl soubor zase veřejný. Oprava: přísná varianta, která vracífalsejen pro „neexistuje“ a ostatní chyby vyhazuje; stejně přísný přesun. - Selhaný přesun hlášen jako úspěšné smazání. Chyba se zalogovala a API vrátilo běžný úspěch. Oprava: doménová funkce vrací i příznak „skryto“; API při neúspěchu odpoví odlišným stavem s vysvětlením a rozhraní ukáže varování místo potvrzení.
- Souběžná změna viditelnosti ze starého snímku smazaný soubor znovu zveřejnila. Oprava: smazání, změna viditelnosti i úklid berou stejný zámek záznamu a stav čtou znovu až po něm; zveřejnění smazaného záznamu se odmítne.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: v konfiguraci proxy/CDN najít cesty vydávané přímo z disku nebo z úložiště objektů a ke každé se zeptat „co se stane se souborem, když ho aplikace smaže nebo znepřístupní?“; v databázi spočítat smazané záznamy, jejichž soubor ve veřejném umístění stále existuje.
- Anti-pattern: oprávnění a stav jen v aplikační vrstvě, zatímco bajty vydává jiná vrstva; testy mazání, které nekontrolují adresu souboru. Pomocné funkce typu
exists(), které polykají chyby, použité jako důkaz nepřítomnosti; operace nad soubory bez zámku sdíleného s ostatními cestami, které tytéž soubory přesouvají. - Lepší přístup: veřejné umístění obsahuje jen to, co má být veřejné právě teď; každá změna stavu (smazání, zneveřejnění, konec platnosti) soubor přesouvá. Pamatovat i na kopie v mezipamětech mimo server – ty oprava zdroje nevrátí.
Sister bugs / související
Sekce “Sister bugs / související”- Stav „chybí originál“ zaměněn za potvrzené fyzické smazání – další rozdíl mezi stavem v databázi a skutečností na disku.