NOTE · 2026.11.09
SQLite 的 WAL 模式:并发、备份与常见误区
SQLite 的 WAL 模式经常被当成一个性能开关,但它真正改变的是事务日志的工作方式。启用之后,写操作追加到 -wal 文件,读操作仍从数据库主文件读取,因此读写可以更好地并行。
三个文件要一起看
启用 WAL 后,目录里通常会出现 db、db-wal 和 db-shm。只复制主数据库文件,可能得到一个缺少最近事务的快照。备份时要么停掉写入进程,要么使用 SQLite 的在线备份接口。
sqlite3 app.db ".backup '/backup/app-$(date +%F).db'"
WAL 文件会增长
长时间运行的连接会阻止 checkpoint 推进,WAL 文件可能持续膨胀。检查 PRAGMA wal_checkpoint(TRUNCATE); 的执行情况,并确认应用没有长期持有不必要的读事务。
适合什么场景
单机、小到中等并发、读多写少的服务很适合 SQLite。涉及多台机器同时写入时,应该回到数据库选型本身,而不是继续给 SQLite 加补丁。
我现在的做法是:定期做在线备份,监控 WAL 大小,升级前先在副本上跑一次恢复演练。工具简单,流程要完整。