// SQLite 錯誤參考

SQLITE_CORRUPT:資料庫磁碟映像已損毀

SQLite 發現資料庫檔案的結構損毀。請停止寫入、先複製一份,再用 .recover 命令或從備份盡量救回資料。

結果代碼
SQLITE_CORRUPT
名稱
11
類別
主要結果代碼
錯誤訊息
database disk image is malformed

它的意義

SQLITE_CORRUPT (11) 表示 SQLite 在檔案中讀到不符合其格式的內容:損毀的頁面、錯誤的指標、沒有對應資料列的索引項目。正常使用下 SQLite 不會自行損毀檔案;SQLite 文件("How To Corrupt An SQLite Database File")列出會造成損毀的情況:在交易開啟時複製檔案、檔案鎖定損壞(常見於網路檔案系統)、刪除熱日誌、硬體或儲存裝置故障,以及其他程式碼寫入檔案。

SQLITE_CORRUPT_INDEX 是一個特殊情況,只有索引受損,而 REINDEX 可能能修復它。

常見原因

  • 在資料庫檔案寫入期間複製或備份,或複製時缺少它的 -wal 檔案旁邊。
  • 刪除 -journal 或 -wal 當機後遺留的檔案。
  • 鎖定不可靠的網路檔案系統或容器磁碟區,讓兩個寫入者同時寫入。
  • 磁碟、記憶體或電源故障,或忽略 fsync 的儲存層。
  • 程式的其他部分正透過開啟的檔案描述子直接寫入檔案。

如何修正

  1. 停止寫入資料庫,並複製該檔案及任何 -wal 和 -journal 檔案,再開始任何操作。

  2. 評估損害。

    PRAGMA integrity_check;
  3. 如果只有索引受到影響,請重建它們。

    REINDEX;
  4. 否則,將資料復原到新的檔案,使用的是 sqlite3 shell 的 .recover 命令,然後檢查結果: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. 如果復原不完整,請從備份還原,並使用 VACUUM INTO 或備份 API,而不是在檔案使用中時複製檔案。

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

相關錯誤

更多主要結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。