// SQLite 错误参考
SQLITE_CONSTRAINT_FOREIGNKEY:外键约束失败
写入会导致子行指向不存在的父行,或者删除仍有子行的父行。外键必须在每个连接上启用。
- 结果代码
SQLITE_CONSTRAINT_FOREIGNKEY- 名称
787- 类别
- 扩展结果代码
它的意思
SQLITE_CONSTRAINT_FOREIGNKEY (787) 表示外键检查失败。SQLite 只在满足以下条件的连接上强制启用外键:连接运行 PRAGMA foreign_keys = ON;为了向后兼容它默认关闭,这就是同一条插入在一个工具里成功、在另一个工具里失败的原因。
该消息没有说明哪个键失败。 PRAGMA foreign_key_check 列出所有违反约束的行。
常见原因
- 插入父 ID 不存在的子行。
- 删除或更新仍有子行的父行,而不指定
ON DELETE CASCADE或者SET NULL. - 以错误顺序加载表:先加载子表再加载父表。
- 延迟约束(
DEFERRABLE INITIALLY DEFERRED)失败于COMMIT.
如何修复它
-
查找违反外键的行。
PRAGMA foreign_key_check; PRAGMA foreign_key_list(orders);
-
先插入父行再插入子行,或者先删除子行再删除父行。
-
对于批量加载,将检查延迟到事务结束。
BEGIN; PRAGMA defer_foreign_keys = ON; -- load tables in any order COMMIT;
-
如果删除父行时应当连带删除子行,请在外键上声明这一操作。
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_CONSTRAINT约束失败23503PostgreSQL:外键约束违反1452MySQL:外键失败:无法添加子行1451MySQL:外键失败:无法删除父行547SQL Server:语句与约束冲突ORA-02291Oracle:违反完整性约束 - 未找到父键ORA-02292Oracle:违反完整性约束 - 找到子记录
更多扩展结果代码错误
SQLITE_ERROR_MISSING_COLLSEQ没有这样的排序规则SQLITE_BUSY_RECOVERY另一个进程正在恢复 WALSQLITE_LOCKED_SHAREDCACHE记录在共享缓存中被锁定SQLITE_CONSTRAINT_CHECKCHECK 约束失败SQLITE_ABORT_ROLLBACK语句因 ROLLBACK 而中止SQLITE_BUSY_SNAPSHOT陈旧读取不能转为写入SQLITE_IOERR_SHORT_READ读取返回的字节数不足SQLITE_CANTOPEN_ISDIR路径是一个目录
代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQLite
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。