SQLite备份:保留WAL数据并验证恢复
SQLite常被当作“一个.db文件”,但应用运行时直接复制这个文件可能得到不完整或不一致的备份。特别是WAL模式,已经提交的数据可能仍在旁边的-wal文件中。推荐使用SQLite提供的在线备份能力,完成后再验证结果;不要把删除-wal或-shm当成整理备份的步骤。
确认实际数据库、版本和写入方式
先从应用配置确认数据库绝对路径和运行账号,核对是否使用多个附加数据库。下面以/srv/app/app.db为例,所有路径均需替换。使用应用所需权限执行只读检查,路径写错时不要继续:
test -f /srv/app/app.db
sqlite3 -readonly /srv/app/app.db "SELECT sqlite_version(); PRAGMA journal_mode;"
第一条应成功,第二条返回实际命令行库版本和当前日志模式。应用内嵌SQLite时,还应在应用连接中查询sqlite_version();命令行升级不代表应用已经使用同一库。采用SQLCipher等加密扩展的数据库需使用兼容工具,普通sqlite3不能直接替代。
WAL并发环境应核对运行库的已知问题修复。2026年官方修复了特定并发写入与检查点条件下的WAL-reset竞态,修复线包括3.51.3及以后,以及3.44.6、3.50.7回移版;发行版还可能有自己的回移补丁。以实际软件的修复证据为准,不为套教程直接替换系统库。
用.backup生成独立的一致副本
由实际备份账号准备仅授权人员可访问的备份目录,确认空间充足,并选择尚不存在的新文件名。本例为app-20261115-01.db;不可覆盖上一份可用备份。
sqlite3 -readonly /srv/app/app.db ".timeout 5000" ".backup '/srv/private-backups/app-20261115-01.db'"
.backup使用SQLite在线备份机制,目标文件应位于网站公开目录之外。它会读取数据库的完整逻辑状态,包括需要从WAL读取的已提交内容;不是把主文件和WAL分别cp一遍。执行报锁等待、空间或权限错误时,保留失败文件与错误状态,换新文件名重试,不能把已生成文件直接标记为成功。
写入频繁时备份可能需要等待或重试;可安排低峰期,必要时通过应用支持的方式短暂停写。多个数据库或数据库加上传文件需要同一业务时点时,还要设计统一停写或应用一致性方案;一份.db成功并不保证跨文件事务也一致。
先检查结构,再检查业务记录
sqlite3 -readonly /srv/private-backups/app-20261115-01.db "PRAGMA integrity_check; PRAGMA foreign_key_check;"
sha256sum /srv/private-backups/app-20261115-01.db
integrity_check通常应返回ok;foreign_key_check正常时不返回违规行,两者用途不同。结构检查通过后,再核对关键表、备份时间附近的已知业务记录及合理数量。不能仅凭文件比昨天大或命令退出成功,判断数据一定满足恢复目标。
恢复演练放在全新位置
- 把已验证备份复制到新的私有恢复目录,核对SHA256一致,不覆盖应用正在使用的数据库。
- 用兼容SQLite版本打开恢复副本,再做结构、关键记录和应用读取验证。
- 启动测试应用时隔离邮件、支付、队列与外部接口,避免演练触发真实动作。
- 正式切换前停止所有写入者,确认原数据库及其配套文件已妥善保留,检查新文件属主和目录权限。
不能在应用仍持有旧连接时直接覆盖.db,也不能把旧库的-wal与新恢复主文件混用。正式替换由应用的停机与恢复流程执行,保留独立旧副本和回退条件,验证后再恢复写入。
最后把备份及所需加密材料保存到独立受控位置,参照SHA256核对和安全恢复原则。完成标准是备份结构正确、目标业务记录存在,且测试应用能够在隔离环境使用恢复副本。