// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。