// PostgreSQL 错误参考
PostgreSQL 23503:外键约束冲突
某行引用了不存在的父键,或者你删除或修改了仍被子行引用的父行。
- SQLSTATE
23503- 名称
foreign_key_violation- 类别
- 违反完整性约束
它的意思
外键要求子列中的每个值都必须存在于被引用的(父)列中。PostgreSQL 会在两个方向上抛出 23503:当你插入或更新一条子行、而它的键没有对应的父行(is not present in table),以及删除或更新仍有子行指向它的父行时(is still referenced from table).
这 DETAIL 行会给出键值和另一张表,你就知道该去查哪些行了。
常见原因
- 在父行之前插入子行,例如先加载
orders在此之前customers. - 子行中的拼写错误或过时的 ID。
- 删除仍有子行的父行,而不指定
ON DELETE CASCADE或者SET NULL在外键上。 - 在子行仍引用旧值时更新父表的主键。
- 两个仅大小写不同的值,出现在声明为
如何修复它
-
找到缺失的父行或剩余的子行。
SELECT * FROM customers WHERE id = 42; SELECT * FROM orders WHERE customer_id = 42;
-
先插入父行,或者在一个事务中加载两张表并把约束设为延迟(必须声明为
DEFERRABLE).ALTER TABLE orders ALTER CONSTRAINT orders_customer_id_fkey DEFERRABLE INITIALLY IMMEDIATE; BEGIN; SET CONSTRAINTS orders_customer_id_fkey DEFERRED; INSERT INTO orders (id, customer_id) VALUES (1, 42); INSERT INTO customers (id, name) VALUES (42, 'Ada'); COMMIT; -- checked here
-
删除父行时,请先删除或重新指派它的子行;如果这正是你想要的行为,也可以改外键的删除规则。
ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey, ADD CONSTRAINT orders_customer_id_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE; -
在向现有数据添加外键之前,先查找孤立记录。
SELECT o.* FROM orders o LEFT JOIN customers c ON c.id = o.customer_id WHERE o.customer_id IS NOT NULL AND c.id IS NULL;
安全地复现它
CREATE TEMP TABLE p (id int PRIMARY KEY); CREATE TEMP TABLE c (p_id int REFERENCES p (id)); INSERT INTO c VALUES (1); -- ERROR: ... violates foreign key constraint "c_p_id_fkey"
相关错误
23505重复键违反唯一约束23502空值违反非空约束42830外键无效2BP01依赖对象仍然存在547SQL Server:语句与约束冲突1452MySQL:外键失败:无法添加子行1451MySQL:外键失败:无法删除父行ORA-02291Oracle:违反完整性约束 - 未找到父键ORA-02292Oracle:违反完整性约束 - 找到子记录SQLITE_CONSTRAINT_FOREIGNKEYSQLite:外键约束失败
更多完整性约束冲突错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。