在使用SQLite数据库时，偶尔会遇到数据库文件损坏，导致无法正常导入导出数据，甚至出现各种奇怪的错误。本文结合一个实际案例，详细讲解如何排查SQLite数据库文件损坏问题，并尝试修复恢复数据。
一、问题背景
在使用如下命令导入SQL备份文件时：
sqlite3 1Panel.db < bak.sql发现数据库文件 1Panel.db 大小始终为0字节，导入无效。查看备份SQL文件内容发现：
文件开头正常，有
BEGIN TRANSACTION;和多条CREATE TABLE、INSERT INTO语句。文件结尾却是：
ROLLBACK; -- due to errors
这说明备份文件执行了回滚操作，所有数据未写入数据库。
二、进一步排查
1. 检查备份SQL文件是否完整
确认备份SQL中是否有 COMMIT; 提交事务，如果没有则需要补充。但本例中备份以 ROLLBACK; 结尾，说明备份时已经出现错误。
2. 检查原始数据库完整性
尝试对原始数据库执行完整性检查：
sqlite3 1Panel.db "PRAGMA integrity_check;"
返回大量错误信息，如：
On tree page XXX cell Y: overflow list length is X but should be Y
2nd reference to page XXX
invalid page number XXX
Page XX is never used
这些错误表明数据库B树结构严重损坏。
三、问题原因分析
SQLite标准
.dump命令不会自动添加ROLLBACK;，出现该语句说明数据库处于异常状态。数据库页结构异常、页号非法等提示文件已损坏。
损坏可能由程序异常退出、磁盘故障或其他原因导致。
四、修复与恢复方案
1. 使用 .recover 命令尝试恢复（SQLite 3.29+）
.recover 是SQLite官方提供的从损坏数据库中提取数据的工具：
sqlite3 1Panel.db ".recover" > recovered.sql该命令会尽可能提取有效数据生成SQL脚本。然后用该脚本创建新库：
sqlite3 new_1Panel.db < recovered.sql检查新库完整性和表结构：
sqlite3 new_1Panel.db "PRAGMA integrity_check;"
sqlite3 new_1Panel.db ".tables"如果返回 ok 且能看到表列表，则恢复成功。
2. 使用第三方工具修复
如果 .recover 效果不理想，可以考虑使用专业的SQLite修复软件或工具进行深度修复。
3. 从备份还原
如果有历史备份（如之前导出的 .sql 文件），建议直接用备份还原。
五、防止未来损坏建议
保证程序正常关闭SQLite连接，避免强制杀死进程。
避免磁盘空间不足或硬件故障。
定期对重要数据库进行备份。
使用事务操作时确保正确提交或回滚。
六、总结
通过本文案例，希望能帮助大家快速定位和处理SQLite数据库损坏问题，提高数据安全保障能力。