// Referencia de errores de PostgreSQL

PostgreSQL 23503: violación de restricción de clave foránea

Una fila hace referencia a una clave padre que no existe, o eliminaste o cambiaste una fila padre a la que las filas hijas aún hacen referencia.

SQLSTATE
23503
Nombre
foreign_key_violation
Categoría
Violación de restricción de integridad
Mensaje de error
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".

Qué significa

Una clave foránea indica que cada valor de la columna hija debe existir en la columna referenciada (principal). PostgreSQL genera el error 23503 en dos casos: cuando insertas o actualizas una fila hija cuya clave no tiene padre (is not present in table), y cuando eliminas o actualizas una fila padre a la que aún apuntan filas hijas (is still referenced from table).

La DETAIL la línea proporciona el valor de la clave y la otra tabla, para que sepas qué filas revisar.

Causas comunes

  • Insertar filas hijas antes de las filas padre, por ejemplo al cargar orders antes customers.
  • Un error tipográfico o un id obsoleto en la fila hija.
  • Eliminar una fila padre que todavía tiene hijos, sin ON DELETE CASCADE o SET NULL en la clave foránea.
  • Actualizar la clave primaria de un padre mientras los hijos hacen referencia al valor antiguo.
  • Dos transacciones: una inserta un hijo para un padre que otra acaba de eliminar.

Cómo solucionarlo

  1. Encontrar el padre que falta o los hijos restantes.

    SELECT * FROM customers WHERE id = 42;
    SELECT * FROM orders WHERE customer_id = 42;
  2. Insertar primero los padres, o cargar ambas tablas en una sola transacción con la restricción diferida (debe declararse 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. Al eliminar un padre, elimina o reasigna primero a sus hijos, o cambia la regla de eliminación de la clave foránea si eso es lo que quieres.

    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. Encuentra los huérfanos antes de añadir una clave foránea a datos existentes.

    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;

Reprodúcelo de forma segura

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"

Errores relacionados

Más errores de violación de restricciones de integridad

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.