// PostgreSQL 错误参考

PostgreSQL 23503:外键约束冲突

某行引用了不存在的父键,或者你删除或修改了仍被子行引用的父行。

SQLSTATE
23503
名称
foreign_key_violation
类别
违反完整性约束
错误信息
insert or update on table "orders" violates foreign key constraint "orders_customer_id_fkey"
DETAIL:  Key (customer_id)=(42) is not present in table "customers".

它的意思

外键要求子列中的每个值都必须存在于被引用的(父)列中。PostgreSQL 会在两个方向上抛出 23503:当你插入或更新一条子行、而它的键没有对应的父行(is not present in table),以及删除或更新仍有子行指向它的父行时(is still referenced from table).

这 DETAIL 行会给出键值和另一张表,你就知道该去查哪些行了。

常见原因

  • 在父行之前插入子行,例如先加载 orders 在此之前 customers.
  • 子行中的拼写错误或过时的 ID。
  • 删除仍有子行的父行,而不指定 ON DELETE CASCADE 或者 SET NULL 在外键上。
  • 在子行仍引用旧值时更新父表的主键。
  • 两个仅大小写不同的值,出现在声明为

如何修复它

  1. 找到缺失的父行或剩余的子行。

    SELECT * FROM customers WHERE id = 42;
    SELECT * FROM orders WHERE customer_id = 42;
  2. 先插入父行,或者在一个事务中加载两张表并把约束设为延迟(必须声明为 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
  3. 删除父行时,请先删除或重新指派它的子行;如果这正是你想要的行为,也可以改外键的删除规则。

    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;
  4. 在向现有数据添加外键之前,先查找孤立记录。

    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"

相关错误

更多完整性约束冲突错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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