// SQLite 错误参考

SQLITE_CONSTRAINT:约束失败

一次 INSERT 或 UPDATE 违反了约束:UNIQUE、PRIMARY KEY、NOT NULL、CHECK 或 FOREIGN KEY。消息和扩展代码指出了是哪一项。

结果代码
SQLITE_CONSTRAINT
名称
19
类别
主要结果代码
错误信息
constraint failed

它的意思

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 表。

如何修复它

  1. 读取消息或扩展代码以查看哪个约束失败,然后查看表定义。

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. 对于你想要合并或跳过的重复项,使用 upsert 或冲突子句。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 对于其他约束,请修正您正在写入的数据:提供缺失的值,先插入父行,或更正未通过检查的值。

相关错误

更多主要结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。