Přeskočit na obsah

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’;

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.

Tři věci dohromady:

  1. 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.
  2. 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.
  3. 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.
  • 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ě.

Přidal aiarchitekt.cz · 14. 11. 2026 1:00
Provozuje aiarchitekt.cz