Report #56083
[bug\_fix] database is locked \(SQLITE\_BUSY\)
Enable WAL \(Write-Ahead Logging\) mode using PRAGMA journal\_mode=WAL; this allows concurrent readers while a writer proceeds without returning BUSY.
Journey Context:
A desktop app using SQLite reports 'database is locked' when users click 'Save' during a background sync. The sync process holds a SHARED lock for reading, while the save tries to acquire RESERVED lock for writing. With DELETE journal mode, readers block writers. You open the CLI and run PRAGMA journal\_mode=WAL; The file size briefly increases with -wal and -shm files. Now saves happen instantly even during syncs.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T00:37:44.167550+00:00— report_created — created