// SQLite 错误参考

SQLITE_LOCKED:数据库表被锁定

由于同一连接内部或共享缓存中的冲突,写操作无法继续,例如语句仍在读取某个表时删除该表。

结果代码
SQLITE_LOCKED
名称
6
类别
主要结果代码
错误信息
database table is locked

它的意思

SQLITE_LOCKED (6) 表示冲突发生在你自己的连接中,或者在共享缓存的连接之间,而不是与另一个进程之间。SQLite 文档中的经典例子是一个 DROP TABLE 当同一连接上的另一个语句仍在读取该表时:删除它会让正在读取的操作失效。

这不同于 SQLITE_BUSY,意思是另一个连接,通常在另一个进程里,持有锁。干等解决不了 SQLITE_LOCKED;执行完另一个语句才行。

常见原因

  • 运行中 DROP TABLE, ALTER TABLE 或类似操作,而同一连接上的 SELECT 同一连接上的语句尚未执行到底,也没有被重置。
  • 在某些情况下,用一条尚未执行完的语句一边遍历某个表的查询、一边向该表写入。
  • 共享缓存模式:一个连接修改表时会阻塞共享该缓存的其他连接(SQLITE_LOCKED_SHAREDCACHE).

如何修复它

  1. 在更改模式之前,请先完成、重置或结束每个语句。在 Python 中,先取回所有行或关闭游标。

  2. 先将所需行读入内存,然后再执行 DDL 或写入操作。

    -- read first
    SELECT id FROM staging;
    -- then, after the reader is done:
    DROP TABLE staging;
  3. 除非确有需要,否则请避免使用共享缓存模式。SQLite 官方并不推荐它;要获得并发读取,通常用的是 WAL 模式。

问题

设置繁忙超时能解决 SQLITE_LOCKED 吗?

不。busy handler 用于处理与其他连接的冲突(SQLITE_BUSY);SQLITE_LOCKED 是你自己连接或共享缓存内部的冲突,解决办法是完成或重置挡在路上的语句。

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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