Souběžní zapisovatelé rozvětví hashovaný journal
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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.
Root cause
Sekce “Root cause”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.
Fix
Sekce “Fix”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.