Vícefázový upload – cizí úklid smaže rozpracovaná data a pozdní fáze spadne chybou úložiště
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Upload běží ve fázích: řádky „rozpracováno“ → dočasné soubory → přesun na místo → řádky „hotovo“. Když se proces zdrží (pomalé spojení, uspaný notebook) a mezitím uživatel záznam odešle ke schválení, upload skončí chybou 500 (ENOENT při přejmenování). V horším případě projde odeslání záznamu s přílohou, kterou odesílající ve své verzi neviděl, nebo naopak dvě specifikace téhož souběhu žádají opačný výsledek.
Root cause
Sekce “Root cause”Tři věci dohromady:
- Navazující operace (odeslání, úklid po časovém limitu) rozpracovaná data právem zahodí, ale pozdní fáze uploadu s tím nepočítá a chybu souborového systému propustí ven.
- Není určeno, co je „obsah“, který se schvaluje: rozpracovaná příloha do něj nepatří, hotová ano – a přechod „rozpracováno → hotovo“ proto musí měnit verzi obsahu ve stejné transakci.
- Pořadí souběhu upload × odeslání × úklid nejsou vyjmenovaná, takže testy ověřují stav vyrobený přímým zápisem do databáze, který běžnou cestou nevznikne.
Fix
Sekce “Fix”- Jádro uploadu: když po chybě zjistí, že jeho řádky už neexistují (nebo jsou smazané), uklidí své soubory a vrátí doménový konflikt „upload se nedokončil“.
- Verze obsahu roste při přechodu přílohy do stavu „hotovo“ (i když ho dokončí úklid), při smazání hotové přílohy a při změně pořadí či popisku; vznik a zahození rozpracované přílohy verzi nemění.
- Odeslání odmítne čerstvě rozpracovanou přílohu („dokončete nahrávání“), po časovém limitu ji samo zahodí; nese verzi, kterou odesílající viděl.
- Tabulka pořadí: upload první / odeslání první / po limitu / souběh na stejném zámku / úklid mezi fázemi / ztráta oprávnění – ke každému jeden očekávaný výsledek a test s háčkem ve fázi uploadu a vloženým časem.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: u každé vícefázové operace se zeptej „co když mi mezi fázemi někdo smaže rozpracovaná data?“ a „kdo další se dívá na rozpracovaný stav?“.
- Anti-pattern: test souběhu, který výchozí stav zapíše přímo do databáze; úklid, který o in-flight operacích neví, a operace, která neví o úklidu.
- Lepší přístup: sdílený zámek entity pro všechny fáze i navazující operace, stav „rozpracováno“ mimo schvalovaný obsah, doménové výsledky místo chyb infrastruktury.
Sister bugs / související
Sekce “Sister bugs / související”Vícefázový upload ověří oprávnění jen před první fází; úklid testu smaže řádek, ale nechá job ve frontě.