// SQLite 错误参考

SQLITE_CONSTRAINT_FOREIGNKEY:外键约束失败

写入会导致子行指向不存在的父行,或者删除仍有子行的父行。外键必须在每个连接上启用。

结果代码
SQLITE_CONSTRAINT_FOREIGNKEY
名称
787
类别
扩展结果代码
错误信息
FOREIGN KEY constraint failed

它的意思

SQLITE_CONSTRAINT_FOREIGNKEY (787) 表示外键检查失败。SQLite 只在满足以下条件的连接上强制启用外键:连接运行 PRAGMA foreign_keys = ON;为了向后兼容它默认关闭,这就是同一条插入在一个工具里成功、在另一个工具里失败的原因。

该消息没有说明哪个键失败。 PRAGMA foreign_key_check 列出所有违反约束的行。

常见原因

  • 插入父 ID 不存在的子行。
  • 删除或更新仍有子行的父行,而不指定 ON DELETE CASCADE 或者 SET NULL.
  • 以错误顺序加载表:先加载子表再加载父表。
  • 延迟约束(DEFERRABLE INITIALLY DEFERRED)失败于 COMMIT.

如何修复它

  1. 查找违反外键的行。

    PRAGMA foreign_key_check;
    PRAGMA foreign_key_list(orders);
  2. 先插入父行再插入子行,或者先删除子行再删除父行。

  3. 对于批量加载,将检查延迟到事务结束。

    BEGIN;
    PRAGMA defer_foreign_keys = ON;
    -- load tables in any order
    COMMIT;
  4. 如果删除父行时应当连带删除子行,请在外键上声明这一操作。

    CREATE TABLE orders (
        id          INTEGER PRIMARY KEY,
        customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE
    );

安全地复现它

PRAGMA foreign_keys = ON;
CREATE TABLE p (id INTEGER PRIMARY KEY);
CREATE TABLE c (pid INTEGER REFERENCES p(id));
INSERT INTO c VALUES (1);  -- Runtime error: FOREIGN KEY constraint failed (19)

问题

为什么我的 SQLite 数据库中外键不生效?

强制执行是针对每个连接的,并且默认是关闭的。每个连接都必须运行 PRAGMA foreign_keys = ON,并且不能在事务中更改。

相关错误

更多扩展结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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