// SQLite 错误参考

SQLITE_PROTOCOL:锁定协议

在 WAL 模式下,某个连接在几秒内多次输掉启动事务的竞争,最终放弃。这种情况非常罕见,说明写入争用非常严重。

结果代码
SQLITE_PROTOCOL
名称
15
类别
主要结果代码
错误信息
locking protocol

它的意思

SQLite 文档描述了 SQLITE_PROTOCOL (15) 表示文件锁定协议出了问题,目前只在 WAL 模式下启动事务时返回。当两个连接竞争启动事务时,落败的一方会退避并重试;如果同一个连接连续几秒都落败,它就会返回 SQLITE_PROTOCOL。它应该只在多个进程激烈竞争写入同一个数据库时出现。

常见原因

  • 多个进程同时写同一个 WAL 模式的数据库。
  • 文件锁行为异常,例如在网络文件系统上。

如何修复它

  1. 减少并发写入者的数量,比如让写入都经由一个进程或一条队列。

  2. 把数据库放在锁机制可靠的本地磁盘上。

  3. 把它当作 SQLITE_BUSY: 稍等片刻后重试事务。

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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