SQLite 事务与 WAL，怎样避免数据只改了一半？

返回 架构与 SDK 目录

标准回答

事务把几步修改当成一个整体：全部成功才提交，失败就撤回。WAL 则是一种记录写入的方式，通常能让读和写更好地并行，但不意味着任意多个写入可以同时进行。

• SQLite 同一时刻仍只有一个写事务，事务尽量短，避免持有事务等待网络。
• WAL 包含日志与检查点过程，备份不能随意只复制一个正在使用的数据库文件。
• 升级表结构要验证迁移前后的数据；本地事务无法包住远端硬件动作。

通俗例子

本地保存“控制指令已完成”时，还要同步保存设备最终状态。两条更新放进同一事务，第二步失败就不提交，避免历史列表显示完成、设备页面却还停在旧状态。

深入解释

**事务把什么绑在一起：**把多条本地数据库修改放进同一次提交，成功时一起生效，失败则撤回这次修改。这样避免只保存了“完成状态”，却没保存对应结果。

**WAL 不解决什么：**WAL 改善读写协作，但同一时间仍只有一个写事务。它既不能让任意多线程无限并行写，也不能把数据库之外的硬件动作自动撤销。

易混淆点

WAL 不等于没有锁；跨端一致性也不能只靠一个本地数据库事务解决。

参考资料

• SQLite 事务
• SQLite WAL

内容来源

• Android · AI Agent 知识手册 · 原条目 job-A06