SQLITE_CORRUPT: a imagem do disco do banco de dados está corrompida
O SQLite encontrou a estrutura do arquivo do banco de dados danificada. Pare de gravar nele, faça uma cópia e recupere o que puder com o comando .recover ou a partir de um backup.
- Código de resultado
SQLITE_CORRUPT- Nome
11- Categoria
- Códigos de resultado primários
O que significa
SQLITE_CORRUPT (11) significa que o SQLite leu algo no arquivo que não se encaixa no seu formato: uma página corrompida, um ponteiro inválido, uma entrada de índice sem linha correspondente. O SQLite não corrompe arquivos por conta própria em uso normal; a documentação do SQLite («Como Corromper um Arquivo de Banco de Dados SQLite») lista o que corrompe: arquivos copiados com uma transação aberta, bloqueio de arquivo defeituoso (geralmente em sistemas de arquivos de rede), exclusão de um diário ativo, falhas de hardware ou de armazenamento, e gravações no arquivo por outro código.
SQLITE_CORRUPT_INDEX é um caso especial em que só um índice está danificado e REINDEX pode corrigi-lo.
Causas comuns
- Copiar ou fazer backup do arquivo do banco de dados enquanto ele estava sendo gravado, ou copiá-lo sem o seu
-walarquivo. - Excluindo um
-journalou-walarquivo deixado após uma falha. - Um sistema de arquivos de rede ou um volume de contêiner com travas pouco confiáveis, deixando dois processos gravar ao mesmo tempo.
- Falhas de disco, memória ou energia, ou uma camada de armazenamento que ignora o fsync.
- Outra parte do programa escrevendo no arquivo diretamente através de um descritor de arquivo aberto.
Como corrigir
-
Pare de escrever no banco de dados e faça uma cópia do arquivo e de quaisquer
-wale-journalarquivos antes de tentar qualquer coisa. -
Meça o dano.
PRAGMA integrity_check;
-
Se apenas os índices forem afetados, reconstrua-os.
REINDEX;
-
Caso contrário, recupere os dados em um novo arquivo com o
sqlite3shell do.recovercomando, então verifique o resultado:sqlite3 broken.db .recover | sqlite3 recovered.db. -
Restaure a partir de um backup se a recuperação estiver incompleta, e faça backups futuros com
VACUUM INTOou a API de backup, em vez de copiar o arquivo enquanto ele está em uso.VACUUM INTO '/backups/app-2026-11-09.db';
Erros relacionados
SQLITE_NOTADBarquivo não é um banco de dadosSQLITE_IOERRerro de E/S do discoSQLITE_BUSYo banco de dados está bloqueado824SQL Server: Erro de E/S baseado em consistência lógica
Mais erros de códigos de resultado primário
SQLITE_ERRORErro de lógica SQLSQLITE_PERMpermissão de acesso negadaSQLITE_ABORTconsulta abortadaSQLITE_LOCKEDa tabela do banco de dados está bloqueadaSQLITE_NOMEMsem memóriaSQLITE_READONLYtentativa de escrever em um banco de dados somente leituraSQLITE_INTERRUPTinterrompidoSQLITE_FULLo banco de dados ou o disco está cheio
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.
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.