知识条目 / SQLite

SQLite 报 database disk image is malformed 如何恢复?

先做完整性检查并立即备份原始文件,再尝试官方恢复工具导出数据;不要在原文件上反复写入。

malformed 表示数据库文件结构损坏,可能由掉电、磁盘故障、并发写入或文件被截断引起。恢复的第一原则是保留原始文件副本。

处理步骤

  1. 立即备份原文件停止写入并复制数据库及 -wal、-shm 文件,保留原始现场用于后续分析。
  2. 执行完整性检查使用 PRAGMA integrity_check 与 quick_check 判断损坏范围是索引、表还是页结构。
  3. 导出可恢复数据使用 sqlite3 命令行 .recover 或 .dump 导出到新库,逐表校验行数与关键数据。
  4. 排查损坏根因检查磁盘健康、掉电记录、并发写入方式与文件系统,修复后再恢复业务。

示例

cp app.db app.db.bak
sqlite3 app.db "PRAGMA integrity_check;"
sqlite3 app.db "PRAGMA quick_check;"

sqlite3 app.db ".recover" | sqlite3 recovered.db
sqlite3 recovered.db "PRAGMA integrity_check;"

损坏文件上的写入可能扩大破坏范围;恢复出的数据需业务校验,不要直接覆盖生产库。

关键词

sqlite · malformed · corrupt · 完整性检查 · integrity_check · .recover · 恢复

官方文档

同库知识