// SQLite 錯誤參考
SQLITE_CORRUPT:資料庫磁碟映像已損毀
SQLite 發現資料庫檔案的結構損毀。請停止寫入、先複製一份,再用 .recover 命令或從備份盡量救回資料。
- 結果代碼
SQLITE_CORRUPT- 名稱
11- 類別
- 主要結果代碼
它的意義
SQLITE_CORRUPT (11) 表示 SQLite 在檔案中讀到不符合其格式的內容:損毀的頁面、錯誤的指標、沒有對應資料列的索引項目。正常使用下 SQLite 不會自行損毀檔案;SQLite 文件("How To Corrupt An SQLite Database File")列出會造成損毀的情況:在交易開啟時複製檔案、檔案鎖定損壞(常見於網路檔案系統)、刪除熱日誌、硬體或儲存裝置故障,以及其他程式碼寫入檔案。
SQLITE_CORRUPT_INDEX 是一個特殊情況,只有索引受損,而 REINDEX 可能能修復它。
常見原因
- 在資料庫檔案寫入期間複製或備份,或複製時缺少它的
-wal檔案旁邊。 - 刪除
-journal或-wal當機後遺留的檔案。 - 鎖定不可靠的網路檔案系統或容器磁碟區,讓兩個寫入者同時寫入。
- 磁碟、記憶體或電源故障,或忽略 fsync 的儲存層。
- 程式的其他部分正透過開啟的檔案描述子直接寫入檔案。
如何修正
-
停止寫入資料庫,並複製該檔案及任何
-wal和-journal檔案,再開始任何操作。 -
評估損害。
PRAGMA integrity_check;
-
如果只有索引受到影響,請重建它們。
REINDEX;
-
否則,將資料復原到新的檔案,使用的是
sqlite3shell 的.recover命令,然後檢查結果:sqlite3 broken.db .recover | sqlite3 recovered.db. -
如果復原不完整,請從備份還原,並使用
VACUUM INTO或備份 API,而不是在檔案使用中時複製檔案。VACUUM INTO '/backups/app-2026-11-09.db';
相關錯誤
更多主要結果碼錯誤
SQLITE_ERRORSQL 邏輯錯誤SQLITE_PERM存取權限遭拒SQLITE_ABORT查詢已中止SQLITE_LOCKED資料庫資料表已鎖定SQLITE_NOMEM記憶體不足SQLITE_READONLY嘗試寫入唯讀資料庫SQLITE_INTERRUPT已中斷SQLITE_FULL資料庫或磁碟已滿
程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 SQLite
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。