// SQLite-Fehlerreferenz

SQLITE_CORRUPT: Datenbank-Disk-Image ist fehlerhaft

SQLite hat festgestellt, dass die Struktur der Datenbankdatei beschädigt ist. Schreib nicht mehr in die Datei, leg eine Kopie an, und stelle mit dem Befehl .recover oder aus einer Sicherung so viel wie möglich wieder her.

Ergebniscode
SQLITE_CORRUPT
Name
11
Kategorie
Primäre Ergebniscodes
Fehlermeldung
database disk image is malformed

Was es bedeutet

SQLITE_CORRUPT (11) bedeutet, dass SQLite etwas in der Datei gelesen hat, das nicht zu seinem Format passt: eine defekte Seite, ein fehlerhafter Zeiger, ein Indexeintrag ohne passende Zeile. SQLite beschädigt Dateien bei normaler Nutzung nicht von selbst; die SQLite-Dokumentation ("How To Corrupt An SQLite Database File") listet auf, was Dateien beschädigt: Dateien, die während einer offenen Transaktion kopiert werden, fehlerhafte Dateisperren (oft auf Netzwerk-Dateisystemen), das Löschen eines Hot-Journals, Hardware- oder Speicherfehler und Schreibvorgänge in die Datei durch anderen Code.

SQLITE_CORRUPT_INDEX ist ein Sonderfall, bei dem nur ein Index beschädigt ist und REINDEX kann das beheben.

Häufige Ursachen

  • Das Kopieren oder Sichern der Datenbankdatei während des Schreibens in diese oder das Kopieren ohne -wal Datei aufbewahrt.
  • Löschen einer -journal oder -wal Datei, die nach einem Absturz übrig blieb.
  • Ein Netzwerk-Dateisystem oder Container-Volume mit unzuverlässiger Sperrung, das zwei gleichzeitigen Schreibern Zugang erlaubt.
  • Festplatten-, Speicher- oder Stromausfälle oder eine Speicherebene, die fsync ignoriert.
  • Ein anderer Teil des Programms schreibt direkt über einen offenen Dateideskriptor auf die Datei.

Wie du es behebst

  1. Hör auf, in die Datenbank zu schreiben, und mache eine Kopie der Datei und aller -wal und -journal Dateien, bevor du etwas ausprobierst.

  2. Miss den Schaden.

    PRAGMA integrity_check;
  3. Wenn nur Indizes betroffen sind, baue sie neu auf.

    REINDEX;
  4. Andernfalls stelle die Daten in einer neuen Datei mit der sqlite3 Shell- .recover Befehl, dann das Ergebnis überprüfen: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. Stelle aus einem Backup wieder her, wenn die Wiederherstellung unvollständig ist, und erstelle künftige Backups mit VACUUM INTO oder der Backup-API, anstatt die Datei zu kopieren, während sie in Gebrauch ist.

    VACUUM INTO '/backups/app-2026-11-09.db';

Zugehörige Fehler

Weitere Fehler bei primären Ergebniscodes

Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQLite in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQLite und die anderen Datenbanken, mit denen du arbeitest.