// Referencia de errores de PostgreSQL

PostgreSQL 23502: valor nulo viola la restricción NOT NULL

Un INSERT o UPDATE dejó una columna NOT NULL vacía, a menudo porque la columna se omitió y no tiene valor predeterminado.

SQLSTATE
23502
Nombre
not_null_violation
Categoría
Violación de restricción de integridad
Mensaje de error
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

Qué significa

A NOT NULL la columna debe tener un valor en cada fila. 23502 significa que la fila nueva o actualizada tenía NULL allí, ya sea explícitamente o porque la columna se dejó fuera de un INSERT y su valor predeterminado es NULL.

La DETAIL la línea muestra toda la fila que falla. PostgreSQL 13 y versiones posteriores nombran la tabla en el mensaje; las versiones más antiguas solo dicen null value in column "email" violates not-null constraint.

Causas comunes

  • La INSERT no incluye la columna y esta no tiene DEFAULT.
  • La aplicación envió NULL, por ejemplo, un campo sin valor o una búsqueda fallida.
  • INSERT ... SELECT o un UPDATE con una subconsulta que no devolvió ninguna fila, produciendo NULL.
  • Una columna añadida con NOT NULL que el código existente no reconoce.

Cómo solucionarlo

  1. Proporciona el valor o dale a la columna un valor predeterminado.

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. Usar COALESCE cuando una búsqueda o expresión puede devolver NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. Si la columna debería permitir valores faltantes, elimina la restricción.

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

Reprodúcelo de forma segura

CREATE TEMP TABLE u (id int, email text NOT NULL);
INSERT INTO u (id) VALUES (1);  -- ERROR: null value in column "email" of relation "u" violates not-null constraint

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.