SQLite 的 WAL 文件，为什么不能随手删

> 日期说明：归档日期为历史整理日期，不代表原始首发时间；本文于 2026-11-02 核对并修订。命令示例需按实际环境替换占位符。


WAL 模式把新事务追加到日志，再在合适的时候 checkpoint 回主数据库。本文整理两个容易忽略的环节，作为日常使用时的检查参考。

<!-- more -->

## WAL 是写入流程的一部分

WAL 模式把新事务追加到日志，再在合适的时候 checkpoint 回主数据库。数据库文件和 WAL 的体积变化，并不一定代表异常。仍有活动连接时，手动删除 WAL 可能破坏正常工作。

## 备份要使用一致性方式

可以使用 SQLite backup API 或 sqlite3 的备份能力，也可以在应用完全停写后整体复制相关文件。不要只复制主数据库文件，就假定获得了最新的完整数据。

## 日常使用的小结

长期存在大 WAL 时，应检查长事务、连接管理与 checkpoint 策略。先理解谁在读写，再决定是否调整数据库参数。


## 操作参考与适用边界

### 通过 SQLite 备份接口导出

```sh
sqlite3 app.db ".backup backup.db"
sqlite3 backup.db "PRAGMA integrity_check;"
```

先确认输入路径，否则 sqlite3 可能创建一个新的空数据库。integrity_check 返回 ok 只验证结构，不证明业务数据完整；仍需核对关键记录与应用启动。

### 如何判断结果

操作后应将实际结果与文中目标对照；命令成功退出只能证明该步骤完成，不能替代业务层验证。记录异常信息时，保留时间、软件版本与相关上下文，方便后续复查。

## 参考资料

- [官方文档与规范](https://www.sqlite.org/backup.html)（本次整理参考，页面内容可能随版本更新）
- [继续阅读本站归档](/archives/)