Error code
SQLite SQLITE_BUSY
SQLITESQLITE_BUSY
Database Error Code· An error code returned by a database server such as PostgreSQL or MySQL.
What it means
database file is locked — another connection holds a shared or reserved lock.
How to fix it
- Retry the operation with a short delay using sqlite3_busy_handler or sqlite3_busy_timeout.
- Switch to WAL journal mode (PRAGMA journal_mode=WAL) which allows concurrent readers alongside a single writer.
- Ensure long-running transactions are committed or rolled back promptly to release locks.
Not affiliated with SQLite. Answer summarized from the manufacturer's manual linked above; consult that source for the authoritative procedure.
More SQLite codes
- SQLITE_AUTHauthorization denied — an authorizer callback blocked the operation
- SQLITE_BUSY_SNAPSHOTWAL snapshot conflict — a snapshot-isolated read cannot see a newer WAL frame
- SQLITE_CANTOPENunable to open the database file
- SQLITE_CONSTRAINTa constraint violation was raised — the write violates a database rule
- SQLITE_CONSTRAINT_FOREIGNKEYFOREIGN KEY constraint failed — the referenced row does not exist
- SQLITE_CONSTRAINT_UNIQUEUNIQUE constraint failed — a duplicate value was inserted
- SQLITE_CORRUPTthe database file is malformed — on-disk structure is damaged
- SQLITE_FULLthe database or disk is full — no space for the write
- SQLITE_IOERRan I/O error occurred on the disk
- SQLITE_LOCKEDa table in the database is locked — conflict within the same connection
- SQLITE_MISMATCHdatatype mismatch — the value type does not fit the affinity
- SQLITE_MISUSElibrary used incorrectly — the API was called in an invalid state