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
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
INSERTno incluye la columna y esta no tieneDEFAULT. - La aplicación envió
NULL, por ejemplo, un campo sin valor o una búsqueda fallida. INSERT ... SELECTo unUPDATEcon una subconsulta que no devolvió ninguna fila, produciendoNULL.- Una columna añadida con
NOT NULLque el código existente no reconoce.
Cómo solucionarlo
-
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();
-
Usar
COALESCEcuando una búsqueda o expresión puede devolverNULL.UPDATE orders o SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
-
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
23505clave duplicada viola la restricción única23503violación de restricción de clave foránea23514violación de la restricción CHECK515SQL Server: No se puede insertar el valor NULL en la columna1048MySQL: la columna no puede ser NULL1364MySQL: el campo no tiene un valor predeterminadoORA-01400Oracle: no se puede insertar NULL en la columnaSQLITE_CONSTRAINT_NOTNULLSQLite: falló la restricción NOT NULL
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.
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.