// SQLite 错误参考

SQLITE_BUSY_SNAPSHOT:过期读取无法升级为写入

在 WAL 模式下,一个以读取开始的事务在另一个连接已经更改数据库后试图写入。等待无济于事;请重新执行事务。

结果代码
SQLITE_BUSY_SNAPSHOT
名称
517
类别
扩展结果代码
错误信息
database is locked

它的意思

SQLITE_BUSY_SNAPSHOT (517) 只发生在 WAL 模式的数据库上。读事务看到的是数据库的一个快照。如果它随后尝试写入,SQLite 必须把它升级为写事务;但如果在快照创建之后另一个连接提交了更改,先前的读取结果就已过时,升级会被拒绝。

不像普通的 SQLITE_BUSY,而调大忙超时也解决不了:事务必须回滚并从头重新运行。

常见原因

  • BEGIN (延迟)然后是 SELECT 随后是 UPDATE,而在此期间另一个进程提交了更改。
  • 应用程序先开长时间的读事务,之后又决定写入。

如何修复它

  1. 会写入的事务请用 BEGIN IMMEDIATE,所以在任何读取之前都会先获取写锁。

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. 真遇到时,回滚并重试整个事务。

    ROLLBACK;

相关错误

更多扩展结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。