// Referencia de errores de MySQL

Error de MySQL 1048: la columna no puede ser nula

Un INSERT o UPDATE puso NULL en una columna declarada como NOT NULL. Proporciona un valor, dale a la columna un valor predeterminado o permite NULL.

Número de error
1048
Nombre
ER_BAD_NULL_ERROR
SQLSTATE
23000
Categoría
Claves y restricciones
Mensaje de error
Column '%s' cannot be null

Qué significa

La columna indicada es NOT NULL, y la instrucción la estableció explícitamente en NULL (o a una expresión que daba como resultado NULL). Si omites la columna se usa su valor predeterminado; si no tiene ninguno, obtienes 1364 en modo estricto.

Causas comunes

  • Código de aplicación que pasa null para un campo obligatorio.
  • Una INSERT ... SELECT o UPDATE ... JOIN donde una búsqueda no encontró ninguna fila y produjo NULL.
  • Una importación CSV donde los campos vacíos se asignan a NULL.

Cómo solucionarlo

  1. Proporciona un valor, o usa uno de reemplazo para NULL.

    INSERT INTO customers (name, country) VALUES ('Ada', COALESCE(@country, 'GB'));
  2. Da a la columna un valor predeterminado y omítela en la inserción.

    ALTER TABLE customers MODIFY country CHAR(2) NOT NULL DEFAULT 'GB';
  3. Si el valor realmente puede ser desconocido, permite NULL.

    ALTER TABLE customers MODIFY country CHAR(2) NULL;

Reprodúcelo de forma segura

CREATE TEMPORARY TABLE t (a INT NOT NULL);
INSERT INTO t VALUES (NULL);  -- ERROR 1048 (23000): Column 'a' cannot be null

Errores relacionados

Más errores de claves y restricciones

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

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

Trabajar con MySQL 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 MySQL y las demás bases de datos que uses.