// Referencia de errores de SQLite

SQLITE_MISUSE: Parámetro incorrecto u otro uso indebido de la API

El programa llamó a una función de SQLite de forma indefinida, como usar una instrucción después de finalizarla. Es un error del código que llama.

Código de resultado
SQLITE_MISUSE
Nombre
21
Categoría
Códigos de resultado primarios
Mensaje de error
bad parameter or other API misuse

Qué significa

SQLITE_MISUSE (21) significa que la aplicación usó mal la API de SQLite. SQLite intenta detectar estos usos indebidos, pero, como subraya su documentación, no hay garantía de detectarlos, así que el mismo error también puede provocar un fallo o corromper la memoria. Cualquier SQLITE_MISUSE es un error que hay que corregir, no una condición que manejar.

Causas comunes

  • Usar una instrucción preparada después de sqlite3_finalize(), o una conexión después de sqlite3_close().
  • Compartir una conexión o instrucción entre hilos sin el modo de subprocesamiento serializado.
  • Llamar sqlite3_step() de nuevo después de que devolvió un error sin restablecer la instrucción.
  • Pasar un manejador de conexión NULL o no válido.

Cómo solucionarlo

  1. Encuentra la llamada que devolvió el código y revisa el ciclo de vida del objeto: prepare, bind, step, reset o finalize, y nunca lo uses después de finalizar.

  2. Dale a cada hilo su propia conexión, o abre conexiones en modo serializado, y no compartas instrucciones entre hilos.

  3. En los bindings de nivel superior, busca objetos usados cuando su conexión ya se ha cerrado, por ejemplo un cursor que se conserva después de close().

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.