Home / Vault & Second Brain / De database was nooit kapot

De database was nooit kapot

Abstract illustration: glowing data threads feeding one intact database core

De foutmelding zei: “file is not a database”

Drie dagen lang begon elke nieuwe sessie in mijn agent-stack met dezelfde twee regels: disk I/O error en daarna file is not a database. Die tweede regel leest als een doodvonnis. Een SQLite-bestand dat “geen database” is, klinkt als beschadigde pagina’s, een mislukte fsync of een schijf die stilletjes ophield de waarheid te vertellen. Mijn eerste ingeving was: backup terugzetten en doorlopen. Die ingeving was fout — en dat is meetbaar.

Voordat ik iets aanraakte, heb ik geteld. Het gateway-proces draaide anderhalve dag en hield 170 open file handles op de geheugendatabase, 166 handles op een verwijderd write-ahead-log en nog één op een verdwenen shared-memory-bestand. Dat is 1.368 van de 4.096 descriptors die het proces mocht gebruiken, vastgehouden door drie bestanden die nooit netjes waren gesloten.


De data was nooit het probleem

Eén commando besliste het: PRAGMA quick_check gaf ok. Het geheugen dat ertoe deed was intact en de werklaag had doorgeschreven tot een paar minuten voordat ik het proces stopte. Er was niets kwijt. De fout zat niet in het bestand, maar in de verbindingsstate eromheen — en de foutmelding beschreef simpelweg het dichtstbijzijnde ding dat niet open wilde.

De oplossing was dus geen restore, maar: gateway netjes stoppen, herbouwen, starten. Tien minuten downtime, en daarna vertelden de cijfers het verhaal beter dan welke logregel ook:

  • handles op verwijderde WAL: 167 → 0
  • handles op de database: 170 → 0
  • totaal descriptors: 1.368 → 34
  • Mnemosyne init failed die dag: 15 → 0

De les die ik blijf herleren

Een foutmelding beschrijft het symptoom dat de code tegenkwam, niet de oorzaak van dat symptoom. “Not a database” is wat de library zegt als hij de header niet kan lezen van het bestand dat hij kreeg — en een proces dat zijn descriptortabel heeft uitgeput levert precies dat soort fouten op. Dezelfde woorden, een compleet ander probleem, en twee compleet verschillende reparatieroutes: de één kost je een restore, de ander een herstart.

De goedkope gewoonte die dat gat dicht, is om naar het proces te kijken vóórdat je naar de data kijkt. Hoeveel descriptors houdt het vast, en op wat? Wanneer is het gestart? Zitten er bestanden tussen die al verwijderd zijn maar nog open staan? Die drie metingen kosten minder dan een minuut en scheiden “de data is stuk” van “het proces is moe”.

Er is een tweede, minder prettige helft. Het lek is niet weg. Drieënvijftig minuten na de herstart stond de teller alweer op 19 handles — sneller dan de ruwweg vier per uur van daarvoor. De herstart kocht dus drie dagen schone sessies, geen genezing. Een herstart laat het symptoom verdwijnen; het laat de bug niet verdwijnen. Juist dat onderscheid moet ik blijven opschrijven, want een monitor die stil wordt is de overtuigendste vorm van vals bewijs.


Daarom staat er nu een watchdog op de teller en een notitie in de vault die het onomwonden zegt: verbindingsstate, geen dataverlies. Blijft het getal klimmen, dan wordt dit een bugreport upstream in plaats van een wekelijks ritueel.

Wat is bij jou de meest misleidende foutmelding die je stack ooit heeft gegeven — de melding die je precies de verkeerde kant op stuurde? Ik verzamel er graag een paar, want elke zo’n melding is een plek waar ik anders opnieuw een middag kan verspillen.

Wat vond je van dit bericht?

Laat een reactie achter

Je e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *