// Referência de erro do SQLite

SQLITE_CANTOPEN: não foi possível abrir o arquivo de banco de dados

O SQLite não conseguiu abrir o arquivo do banco de dados ou um de seus arquivos temporários: um caminho incorreto, um diretório ausente, um problema de permissões ou um caminho que é um diretório.

Código de resultado
SQLITE_CANTOPEN
Nome
14
Categoria
Códigos de resultado primários
Mensagem de erro
unable to open database file

O que significa

SQLITE_CANTOPEN (14) significa que o sistema operacional se recusou a abrir um arquivo de que o SQLite precisava. Geralmente é o arquivo principal do banco de dados, mas pode ser também um arquivo temporário. O SQLite cria um novo arquivo de banco de dados quando o caminho não existe, então esse erro geralmente significa que o diretório está ausente ou sem permissão de gravação, e não que o arquivo esteja ausente.

Códigos estendidos especificam melhor o problema, por exemplo SQLITE_CANTOPEN_ISDIR (o caminho é um diretório) e SQLITE_CANTOPEN_FULLPATH (não foi possível resolver o caminho completo).

Causas comuns

  • O diretório no caminho não existe; o SQLite cria arquivos, não diretórios.
  • Um caminho relativo resolvido contra um diretório de trabalho inesperado, por exemplo em um serviço ou em um executor de testes.
  • Sem permissão para ler o arquivo ou para criá-lo naquele diretório.
  • O caminho aponta para um diretório (SQLITE_CANTOPEN_ISDIR).
  • O diretório temporário está ausente ou não é gravável, então um arquivo temporário não pode ser criado.
  • Muitos arquivos abertos no processo.

Como corrigir

  1. Use um caminho absoluto e verifique se todos os diretórios nele existem.

  2. Verifique as permissões do arquivo e de seu diretório para o usuário com o qual o programa está sendo executado.

  3. Se arquivos temporários forem o problema, aponte o SQLite para um diretório gravável com a SQLITE_TMPDIR ou TMPDIR variável de ambiente, ou mantenha o armazenamento temporário na memória.

    PRAGMA temp_store = MEMORY;
  4. No sqlite3 shell, confirme o que foi aberto.

    .databases

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.