Error code
SQLite SQLITE_CONSTRAINT
SQLITESQLITE_CONSTRAINT
Database Error Code· An error code returned by a database server such as PostgreSQL or MySQL.
What it means
a constraint violation was raised — the write violates a database rule.
How to fix it
- Inspect the extended error code with sqlite3_extended_errcode to identify which constraint was violated.
- Validate data in application code before writing and use ON CONFLICT clauses (REPLACE or IGNORE) for expected conflicts.
- Check the schema with PRAGMA table_info(<table>) to see all constraints.
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_BUSYdatabase file is locked — another connection holds a shared or reserved lock
- SQLITE_BUSY_SNAPSHOTWAL snapshot conflict — a snapshot-isolated read cannot see a newer WAL frame
- SQLITE_CANTOPENunable to open the database file
- 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