// Referencia de errores de SQLite

SQLITE_ERROR: Error de lógica SQL

Código de error genérico de SQLite: un error de sintaxis, una tabla o columna que no existe u otro problema con el SQL. El motivo real está en el mensaje de error, no en el código.

Código de resultado
SQLITE_ERROR
Nombre
1
Categoría
Códigos de resultado primarios
Mensaje de error
SQL logic error

Qué significa

SQLITE_ERROR (1) es el código que SQLite usa cuando no aplica uno más específico. Casi cualquier error del propio SQL acaba aquí: una errata, una tabla o columna que no existe, una tabla que ya existe, un número equivocado de valores. El texto genérico es SQL logic error; el mensaje de sqlite3_errmsg() dice lo que realmente salió mal, por ejemplo no such table: users, no such column: emial, near "FORM": syntax error o table users already exists.

Como un mismo código puede cubrir muchos problemas, registra el mensaje y léelo siempre.

Causas comunes

  • Un error de sintaxis: near "...": syntax error apunta al token donde falló el parseo.
  • no such table: el nombre de la tabla está mal escrito, se encuentra en una base de datos adjunta que no calificaste, o el programa abrió un archivo de base de datos diferente (a menudo nuevo y vacío) del que crees.
  • no such column: una columna mal escrita, o un literal de cadena entre comillas dobles que SQLite tomó como nombre de columna.
  • table ... already exists de un CREATE TABLE sin IF NOT EXISTS.
  • Usar sintaxis o funciones demasiado nuevas para tu versión de SQLite, como RETURNING (3.35) o funciones de ventana (3.25).

Cómo solucionarlo

  1. Lee el mensaje completo y corrige lo que menciona. Comprueba el esquema al que estás realmente conectado:

    SELECT name, type FROM sqlite_schema ORDER BY name;
    PRAGMA table_info(users);
  2. Si falta una tabla, comprueba qué archivo está abierto. Una ruta relativa abre un archivo relativo al directorio de trabajo del proceso, y abrir una ruta que no existe crea una base de datos nueva y vacía.

    PRAGMA database_list;
  3. Usa comillas simples para literales de cadena y comillas dobles solo para identificadores.

    SELECT * FROM users WHERE status = 'active';
  4. Comprueba la versión de la biblioteca cuando falle la sintaxis más reciente.

    SELECT sqlite_version();

Reprodúcelo de forma segura

SELECT * FROM no_such_table;   -- Parse error: no such table: no_such_table

Errores relacionados

Más errores de códigos de resultado principales

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.