SQLite执行BEGIN EXCLUSIVE失败时是否会在busy_timeout周期内持续重试？

开发者阿泽

2026-10-2

SQLite 锁机制与busy_timeout配置说明

BEGIN EXCLUSIVE、BEGIN IMMEDIATE语句触发的锁请求会严格遵循busy_timeout的设定：当请求的锁被其他连接占用时，会按照设定的超时时长、内置的重试间隔持续尝试获取锁，直到超时时间耗尽后才会返回SQLITE_BUSY错误。
busy_timeout配置对表级锁、数据库级锁均生效：该配置设置的是全局忙处理程序，只要触发锁冲突（无论是全库级的EXCLUSIVE/RESERVED锁，还是WAL模式下的表级锁），都会触发重试等待逻辑，不会区分锁的粒度。
你提到的多线程操作场景可以通过该配置实现预期效果：当某线程已经持有数据库EXCLUSIVE锁时，其他线程执行BEGIN EXCLUSIVE触发锁冲突后，不会立刻返回报错，会持续尝试获取锁直到超出你设置的busy_timeout时长后才抛出失败错误。
相关逻辑的官方说明可查阅SQLite官方文档中C3接口busy_timeout章节、事务锁机制章节。