// Referência de erro do SQLite

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
Mensagem de erro
database disk image is malformed

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 -wal arquivo.
  • Excluindo um -journal ou -wal arquivo 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

  1. Pare de escrever no banco de dados e faça uma cópia do arquivo e de quaisquer -wal e -journal arquivos antes de tentar qualquer coisa.

  2. Meça o dano.

    PRAGMA integrity_check;
  3. Se apenas os índices forem afetados, reconstrua-os.

    REINDEX;
  4. Caso contrário, recupere os dados em um novo arquivo com o sqlite3 shell do .recover comando, então verifique o resultado: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. Restaure a partir de um backup se a recuperação estiver incompleta, e faça backups futuros com VACUUM INTO ou 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

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.