// SQLite 错误参考
SQLITE_CONSTRAINT:约束失败
一次 INSERT 或 UPDATE 违反了约束:UNIQUE、PRIMARY KEY、NOT NULL、CHECK 或 FOREIGN KEY。消息和扩展代码指出了是哪一项。
- 结果代码
SQLITE_CONSTRAINT- 名称
19- 类别
- 主要结果代码
它的意思
SQLITE_CONSTRAINT (19) 表示某条语句会违反表的某条规则,因此 SQLite 停止了该语句。通用文本为 constraint failed,但消息通常会指出规则和列,例如 UNIQUE constraint failed: users.email,而且扩展错误码会告诉你属于哪一类: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT 表) 或 _TRIGGER (一个 RAISE() 于触发器中)。
默认情况下,失败的语句会被撤销(冲突模式 ABORT),但同一事务中的早期语句会保留。
常见原因
- 主键或唯一列中出现重复值。
- 一个 NULL 在
NOT NULL列中出现 NULL,通常是因为插入语句未包含该列且该列没有默认值。 - 一个值未通过
CHECK表达式。 - 父行不存在的子行,且设置了
PRAGMA foreign_keys = ON. - 一个类型不对的值,出现在
STRICT表。
如何修复它
-
读取消息或扩展代码以查看哪个约束失败,然后查看表定义。
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
对于你想要合并或跳过的重复项,使用 upsert 或冲突子句。
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
对于其他约束,请修正您正在写入的数据:提供缺失的值,先插入父行,或更正未通过检查的值。
相关错误
SQLITE_CONSTRAINT_UNIQUEUNIQUE 约束失败SQLITE_CONSTRAINT_PRIMARYKEY主键约束失败SQLITE_CONSTRAINT_NOTNULLNOT NULL 约束失败SQLITE_CONSTRAINT_CHECKCHECK 约束失败SQLITE_CONSTRAINT_FOREIGNKEY外键约束失败SQLITE_CONSTRAINT_DATATYPE值不符合 STRICT 列的类型要求
更多主要结果代码错误
SQLITE_ERRORSQL 逻辑错误SQLITE_PERM访问权限被拒绝SQLITE_ABORT查询已中止SQLITE_BUSY数据库已锁定SQLITE_LOCKED数据库表被锁定SQLITE_NOMEM内存不足SQLITE_READONLY尝试写入只读数据库SQLITE_INTERRUPT已中断
代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQLite
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。