Přeskočit na obsah

Souběžní zapisovatelé rozvětví hashovaný journal

import { Aside } from ‘@astrojs/starlight/components’;

Služba zapisovala hashovaný append-only journal a samostatné administrační CLI do stejného souboru. Oba procesy současně načetly stejný poslední záznam a vytvořily událost se stejným pořadovým číslem. Za běhu se chyba nemusela projevit, ale po restartu kontrola integrity správně skončila fail-closed na duplicitní sekvenci.

Fronta zápisů byla pouze instanční:

class Journal {
appendQueue = Promise.resolve();
}

To serializuje volání jednoho objektu, ne dva procesy. Oba zapisovatelé tedy mohli provést stejný cyklus read last → derive seq/hash → append nad totožným stavem.

Každý open a append získá atomický souborový zámek platný pro všechny procesy. append teprve pod zámkem znovu načte a ověří kompletní journal, odvodí následující sekvenci a hash, zapíše řádek, provede datasync a zámek uvolní. Zámek má bounded timeout a smí odstranit jen prokazatelně osiřelý záznam po mrtvém procesu.

Poškozený journal se opravuje pouze s odstavenými zapisovateli: nejdřív vznikne neměnná záloha s digestem, všechny fyzické události se validují a zachovají v pořadí, větev se znovu zřetězí a oprava se sama zapíše jako auditní událost.

Současně je nutné zamknout mutující executor ještě před prvním asynchronním journal zápisem. Jinak může druhá mutace projít kontrolou v okně mezi autorizací a nastavením příznaku aktivní operace.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: spusťte dva nezávislé objekty nebo procesy, které současně appendují do jednoho journalu, a potom soubor znovu otevřete s úplným ověřením řetězce.
  • Anti-pattern: pouze in-memory fronta, přičemž stejný soubor používá služba i CLI.
  • Lepší přístup: jediný writer proces nebo cross-process lock; pořadové číslo se vždy počítá až z čerstvého stavu načteného pod zámkem.
  • Recovery: nikdy nemažte jednu větev bez evidence. Zachovejte původní bajty, jejich digest a explicitní záznam o způsobu opravy.

Sister bugs / související

Sekce “Sister bugs / související”

Stejný princip platí pro outboxy, auditní logy a souborové event store. Databázové transakce řeší souběh uvnitř databáze, ale neochrání samostatný souborový journal.

Přidal aiarchitekt.cz · 29. 8. 2026 2:00
Provozuje aiarchitekt.cz