// Referência de erro do SQLite

SQLITE_MISUSE: parâmetro incorreto ou outro uso inadequado da API

O programa chamou uma função SQLite de maneira indefinida, como usar uma instrução após finalizá-la. É um bug no código de chamada.

Código de resultado
SQLITE_MISUSE
Nome
21
Categoria
Códigos de resultado primários
Mensagem de erro
bad parameter or other API misuse

O que significa

SQLITE_MISUSE (21) significa que a aplicação usou a API do SQLite incorretamente. O SQLite tenta detectar o uso inadequado, mas, como a documentação ressalta, a detecção não é garantida, então o mesmo erro também pode causar falha ou corromper a memória. Qualquer SQLITE_MISUSE é um bug a ser corrigido, não uma condição a ser tratada.

Causas comuns

  • Usar uma declaração preparada depois de sqlite3_finalize()ou uma conexão depois de sqlite3_close().
  • Compartilhar uma conexão ou instrução entre threads sem o modo de threading serializado.
  • Chamar sqlite3_step() novamente depois que retornou um erro sem redefinir a instrução.
  • Passar um identificador de conexão NULO ou inválido.

Como corrigir

  1. Encontre a chamada que retornou o código e verifique o ciclo de vida do objeto: prepare, bind, step, reset ou finalize, e nunca o utilize após finalizar.

  2. Dê a cada thread sua própria conexão, ou abra conexões em modo serializado, e não compartilhe instruções entre threads.

  3. Em bindings de nível mais alto, procure por objetos usados após sua conexão ter sido fechada, por exemplo, um cursor mantido após close().

Erros relacionados

Mais erros de códigos de resultado primário

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQLite no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQLite e os outros bancos de dados que você usa.