// Referencia de errores de SQLite

SQLITE_CONSTRAINT_NOTNULL: Falló la restricción NOT NULL

Un INSERT o UPDATE intentó guardar NULL en una columna NOT NULL, a menudo porque se omitió la columna y no tiene valor predeterminado. El mensaje la nombra.

Código de resultado
SQLITE_CONSTRAINT_NOTNULL
Nombre
1299
Categoría
Códigos de resultado extendidos
Mensaje de error
NOT NULL constraint failed: users.name

Qué significa

SQLITE_CONSTRAINT_NOTNULL (1299) significa un NOT NULL la columna habría recibido NULL. Eso pasa cuando pasas NULL explícitamente, y también cuando un INSERT omite una NOT NULL columna que no tiene un DEFAULT, porque la columna que falta recibe NULL.

Causas comunes

  • La INSERT lista de columnas omite una columna obligatoria sin valor por defecto.
  • La aplicación pasó NULL o None porque no tenía ese valor.
  • Añadir una NOT NULL columna en una reconstrucción de tabla sin completarla para las filas existentes.

Cómo solucionarlo

  1. Proporciona un valor para la columna o asígnale un valor predeterminado.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. Comprueba qué columnas son obligatorias.

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. Para añadir una columna obligatoria a una tabla existente, asígnale un valor predeterminado para que las filas existentes tengan un valor.

    ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

Reprodúcelo de forma segura

CREATE TABLE users (email TEXT, name TEXT NOT NULL);
INSERT INTO users (email) VALUES ('a@x');  -- Runtime error: NOT NULL constraint failed: users.name (19)

Errores relacionados

Más errores de códigos de resultado extendidos

El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.

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

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