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
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
-walDatei aufbewahrt. - Löschen einer
-journaloder-walDatei, 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
-
Hör auf, in die Datenbank zu schreiben, und mache eine Kopie der Datei und aller
-walund-journalDateien, bevor du etwas ausprobierst. -
Miss den Schaden.
PRAGMA integrity_check;
-
Wenn nur Indizes betroffen sind, baue sie neu auf.
REINDEX;
-
Andernfalls stelle die Daten in einer neuen Datei mit der
sqlite3Shell-.recoverBefehl, dann das Ergebnis überprüfen:sqlite3 broken.db .recover | sqlite3 recovered.db. -
Stelle aus einem Backup wieder her, wenn die Wiederherstellung unvollständig ist, und erstelle künftige Backups mit
VACUUM INTOoder 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
SQLITE_NOTADBDatei ist keine DatenbankSQLITE_IOERRFestplatten-I/O-FehlerSQLITE_BUSYDatenbank ist gesperrt824SQL Server: Anmeldung kann auf die Datenbank nicht zugreifen
Weitere Fehler bei primären Ergebniscodes
SQLITE_ERRORSQL-LogikfehlerSQLITE_PERMZugriffsberechtigung verweigertSQLITE_ABORTAbfrage abgebrochenSQLITE_LOCKEDDatenbanktabelle ist gesperrtSQLITE_NOMEMkein Speicher mehrSQLITE_READONLYVersuch, in eine schreibgeschützte Datenbank zu schreibenSQLITE_INTERRUPTunterbrochenSQLITE_FULLDatenbank oder Festplatte ist voll
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.
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.