知识条目 / SQLite
SQLite 的 WAL 模式如何影响并发写入?
说明 WAL 下读写并行、单写者限制、检查点与共享内存文件带来的并发注意事项。
WAL 允许读事务与写事务并行,但同一时刻仍只有一个写者。写入冲突通常表现为 SQLITE_BUSY,需要设置合理的忙等待并缩短写事务。
处理步骤
- 理解并发模型WAL 模式下读不阻塞写、写不阻塞读,但写入仍然串行。多个连接同时写时,后到者会等待或返回 SQLITE_BUSY。
- 设置忙等待超时通过 busy_timeout 让连接在锁冲突时等待一段时间,而不是立即失败;超时值需结合业务延迟目标与事务长度设定。
- 缩短写事务把多条写操作合并到单个短事务,避免在事务中执行网络请求或长时间计算,减少写锁持有时间和检查点压力。
- 关注检查点与文件WAL 文件会随写入增长,需要自动或手动检查点回收。WAL 依赖共享内存,不适合放在不支持共享内存的网络文件系统上。
示例
PRAGMA journal_mode = WAL;
PRAGMA synchronous = NORMAL;
PRAGMA busy_timeout = 5000;
PRAGMA wal_checkpoint(PASSIVE);
PRAGMA journal_mode;
WAL 文件与共享内存文件需与数据库同目录可写。NORMAL 同步在断电时可能丢失最近事务,按业务取舍。
关键词
sqlite · wal · 并发 · 写锁 · busy · checkpoint · journal_mode · database is locked · 共享内存