// SQLite 错误参考

SQLITE_CONSTRAINT_NOTNULL:NOT NULL 约束失败

INSERT 或 UPDATE 尝试在 NOT NULL 列中存储 NULL,通常是因为该列被省略且没有默认值。消息会指出是哪一列。

结果代码
SQLITE_CONSTRAINT_NOTNULL
名称
1299
类别
扩展结果代码
错误信息
NOT NULL constraint failed: users.name

它的意思

SQLITE_CONSTRAINT_NOTNULL (1299) 表示一种 NOT NULL 列会收到 NULL。显式传入 NULL 时会这样,而当一个 INSERT 漏掉了某个 NOT NULL 列没有 DEFAULT,因为缺失的列会得到 NULL。

常见原因

  • 这 INSERT 列列表漏掉了某个没有默认值的必需列。
  • 应用程序对一个它没有的值传入了 NULL 或 None。
  • 添加一个 NOT NULL 列,重建表时无需为现有行填值。

如何修复它

  1. 为该列提供一个值,或者给它一个默认值。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. 检查哪些列是必需的。

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. 要向现有表添加必填列,请为它指定默认值,让已有的行都能获得值。

    ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

安全地复现它

CREATE TABLE users (email TEXT, name TEXT NOT NULL);
INSERT INTO users (email) VALUES ('a@x');  -- Runtime error: NOT NULL constraint failed: users.name (19)

相关错误

更多扩展结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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