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