// SQLite 错误参考

SQLITE_CONSTRAINT_CHECK:CHECK 约束失败

某行未通过表上的 CHECK 表达式。消息会给出约束的名称,约束没有名称时则显示该表达式。

结果代码
SQLITE_CONSTRAINT_CHECK
名称
275
类别
扩展结果代码
错误信息
CHECK constraint failed: price_positive

它的意思

SQLITE_CONSTRAINT_CHECK (275) 表示一个值使 CHECK 表达式为假。给约束起个名字(CONSTRAINT price_positive CHECK (price > 0)),这样错误消息会告诉你哪条规则没通过;对于未命名的约束,新版 SQLite 会直接把表达式打印出来。

求值结果为 NULL 的 CHECK 约束会通过,因此 CHECK (price > 0) 不会拒绝 NULL 价格。

常见原因

  • 一个超出允许范围或列表的值。
  • 不符合模式的文本,例如 CHECK (email LIKE '%@%').
  • 模拟枚举或布尔类型的 CHECK 约束收到了意外值。

如何修复它

  1. 查看约束定义。

    SELECT sql FROM sqlite_schema WHERE name = 'products';
  2. 修正该值,如果数据正确而规则错误,则更改规则。SQLite 无法就地修改 CHECK;使用新定义重建表。

  3. 为约束命名,让报错信息更易读。

    CREATE TABLE products (
        id    INTEGER PRIMARY KEY,
        price REAL NOT NULL CONSTRAINT price_positive CHECK (price > 0)
    );

相关错误

更多扩展结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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