Banco de dados

Como recuperar um banco de dados MongoDB corrompido?

Caio
20 min de leitura

O MongoDB parou de responder, o mongod não sobe ou uma coleção específica começou a retornar erro em produção — e agora é preciso decidir, sob pressão, o que fazer antes de piorar o quadro. Este guia trata da recuperação de banco de dados MongoDB corrompido com foco em diagnóstico e ação segura: como ler os erros do WiredTiger, validar arquivos e coleções, preservar evidências e escolher entre reparo local e laboratório especializado.

O que significa um banco MongoDB corrompido (e o que não significa)

Um banco MongoDB corrompido é aquele cujo mecanismo de armazenamento — na maioria dos casos o WiredTiger — não consegue mais ler, validar ou manter a integridade dos arquivos de dados (.wt), dos índices ou dos metadados internos de forma consistente. A corrupção se manifesta quando estruturas internas como páginas B-tree, checksums ou o próprio log de transações do WiredTiger entram em estado que o processo mongod não consegue interpretar. Isso é diferente de lentidão, de falta de espaço em disco ou de uma configuração mal ajustada: são condições operacionais que degradam o desempenho, mas não violam a integridade estrutural dos arquivos.

Corrupção também não é sinônimo de perda definitiva. Arquivos .wt danificados frequentemente preservam frações significativas dos documentos originais, e o trabalho de recuperação consiste exatamente em extrair essas frações com o menor dano possível. O termo “corrompido” descreve um estado de inconsistência, não um veredito de irrecuperabilidade — embora tentativas caseiras mal conduzidas possam, sim, transformar um caso recuperável em perda definitiva.

Precisa recuperar seus dados?

Laboratório próprio e atendimento emergencial. Chame no WhatsApp e receba o diagnóstico.

Recuperar meus dados

Sintomas e mensagens de erro que indicam corrupção no WiredTiger

O primeiro sinal de corrupção costuma aparecer no log do mongod, não na aplicação. Erros como WT_CURSOR.checkpoint: read checksum error, WT_PAGE: file does not exist ou WiredTiger error (WT_TRY_SALVAGE) indicam que o mecanismo de armazenamento encontrou uma página que não corresponde ao checksum gravado. Outro padrão clássico é o processo iniciar, permanecer ativo por alguns segundos e encerrar com Fatal Assertion — comportamento típico de inconsistência detectada durante a recuperação automática do journal.

Também merece atenção o crescimento anormal de arquivos de salvage ou a presença de mensagens como metadata corruption no wt.verify. Em ambientes com replica set, um nó que entra em estado RECOVERING e nunca volta a SECONDARY, reiniciando repetidamente, é forte indício de que os dados locais não passam mais na validação interna do WiredTiger.

Falhas na inicialização do mongod e erros de WT_

Quando o mongod não sobe, o diagnóstico começa pela leitura atenta do log. Erros prefixados por WT_ apontam diretamente para o WiredTiger: WT_NOTFOUND sugere arquivo de coleção ausente ou renomeado; WT_PANIC indica que o próprio motor abandonou a operação por inconsistência grave; WT_CORRUPTION é o mais explícito — o WiredTiger identificou corrupção estrutural e interrompeu o processo para não propagar o dano.

  • WT_PANIC: inconsistência grave, motor encerra operação.
  • WT_CORRUPTION: corrupção estrutural confirmada em página ou índice.
  • WT_NOTFOUND: arquivo de coleção ausente ou caminho quebrado.
  • Fatal Assertion logo após o start: falha na recuperação do journal.
  • Loop de RECOVERING em replica set: validação local não conclui.

Não confunda esses erros com falha de porta, de permissão de arquivo ou de configuração de bind_ip. Esses últimos geram mensagens do sistema operacional ou do próprio MongoDB, sem o prefixo WT_, e raramente indicam dano estrutural — são problemas de ambiente, não de integridade de dados.

Collection ou índice inacessível com o servidor no ar

Há casos em que o mongod permanece ativo, mas uma coleção específica passa a retornar erro em consultas, contagens ou agregações. O sintoma clássico é o erro Query failed with error code 2 (BadValue) ou mensagens de corrupt document ao percorrer o cursor. Isso sugere que apenas um subconjunto de páginas daquela coleção foi afetado — cenário comum quando a corrupção decorre de setores defeituosos no disco subjacente, e não de falha generalizada no banco.

Índices corrompidos, por outro lado, costumam se manifestar como resultados incorretos ou ausentes em consultas que deveriam usar o índice, acompanhados de avisos no log sobre index build failed ou key out of order. Nesses casos, descartar e reconstruir o índice pode resolver o problema sem tocar nos dados — mas é preciso confirmar antes que a coleção em si está íntegra.

Diferença entre corrupção lógica, corrupção física e falha de storage

Corrupção lógica nasce de escrita inconsistente: queda de energia sem journal habilitado, bug de aplicação, operação de manutenção interrompida ou erro humano. O arquivo existe, o disco está saudável, mas o conteúdo interno não respeita as regras do WiredTiger. Corrupção física decorre de setores ilegíveis, mídia degradada ou controladora defeituosa — o arquivo está no lugar, mas parte dos bytes não pode ser lida, e o checksum falha por causa do hardware.

Falha de storage é uma categoria à parte: o disco, o RAID ou o volume LVM deixam de responder, e o MongoDB perde acesso ao diretório dbPath inteiro. Nesse cenário, a corrupção é consequência, não causa — e a prioridade deixa de ser o banco e passa a ser a preservação do subsistema de armazenamento. Em ambientes corporativos, essa distinção define se o caso vai para o DBA ou para um laboratório de recuperação de storage.

Diagnóstico antes de tentar qualquer reparo

A regra que separa recuperação bem-sucedida de perda definitiva é a ordem das ações. Antes de qualquer comando de reparo, é preciso saber exatamente o que está corrompido, em que extensão e se a mídia subjacente é confiável.

O diagnóstico em MongoDB segue três camadas: validação do motor de armazenamento, validação lógica das coleções e avaliação do hardware. Cada camada responde a uma pergunta diferente — e a resposta define se o próximo passo é restaurar backup, reconstruir índice, extrair documentos ou interromper tudo e preservar evidências.

Verificação com mongod –repair em modo somente leitura

O comando mongod –repair não é uma ferramenta de diagnóstico — é uma operação destrutiva por natureza, pois reescreve arquivos de dados e descarta o que não consegue validar. Executá-lo sobre a única cópia dos dados viola o princípio básico de preservação de evidências. A prática segura é rodar o reparo apenas sobre uma cópia integral do diretório dbPath, nunca sobre o original.

Antes do reparo, o WiredTiger oferece o utilitário wt verify, que percorre os arquivos .wt e reporta inconsistências sem alterar nada. É essa leitura prévia — combinada com a análise do log do mongod — que permite estimar a extensão do dano e decidir se o reparo local tem chance de sucesso ou se o caso exige extração em nível de arquivo.

db.stats(), db.collection.validate() e o que cada retorno indica

Com o servidor no ar, db.stats() fornece uma visão geral: tamanho de dados, de índices, número de coleções e uso de armazenamento. Valores que não batem com o esperado — coleções gigantes com poucos documentos, ou tamanho de índice desproporcional — sugerem metadados inconsistentes. db.collection.validate() é mais profundo: percorre documentos e índices e retorna flags como valid, errors e corrupt.

  • db.stats() com tamanho anormal: metadados de coleção inconsistentes.
  • validate() com valid: false: documentos ou índices fora de ordem.
  • validate() com corrupt: true: dano estrutural confirmado na coleção.
  • Erro de cursor durante a validação: página ilegível no meio da coleção.
  • Validação limpa em todas as coleções: problema está no storage, não no banco.

O retorno de validate() precisa ser interpretado com cautela: um resultado valid: true não garante que o disco esteja saudável — apenas que as estruturas lidas até aquele momento estavam coerentes. Setores defeituosos podem corromper páginas que ainda não foram acessadas. Por isso, validação lógica nunca substitui teste de leitura no nível do hardware.

Quando parar tudo e preservar a imagem do disco

Existem sinais que indicam o momento de interromper qualquer intervenção local. Se o disco apresenta ruídos, se o sistema operacional reporta erros de I/O crescentes, se o SMART indica setores realocados em alta ou se o volume entra em modo somente leitura, cada nova tentativa de leitura destrói mais mídia. Nesse ponto, a prioridade deixa de ser o MongoDB e passa a ser a criação de uma imagem forense do disco — cópia bit a bit, setor por setor, feita com hardware de leitura controlada.

A imagem preserva o estado atual e permite trabalhar sobre uma réplica sem risco adicional ao original. Para bancos em produção com parada operacional, essa etapa é o que separa a recuperação viável do agravamento por insistência. A lógica é a mesma aplicada a volumes ext4 em NAS: primeiro congela-se o estado, depois se analisa.

Recuperação com backup: mongorestore, oplog e point-in-time

Quando existe backup íntegro, a recuperação segue um fluxo previsível: restaurar o dump mais recente, reaplicar as operações posteriores ao dump e validar o resultado. A complexidade está nos detalhes — formato do backup, janela de perda aceitável e consistência entre dados e índices. Um backup mal planejado pode restaurar documentos sem os índices correspondentes ou trazer de volta um estado já corrompido.

Backups de MongoDB se dividem em três famílias: dumps lógicos (BSON/BSON.gz), snapshots de filesystem ou de volume (EBS, LVM) e backups nativos de replica set com oplog. Cada uma tem um procedimento de restauração distinto e um limite diferente de perda de dados.

Restaurando dump BSON/BSON.gz com mongorestore

O mongorestore lê arquivos BSON gerados pelo mongodump e os insere no banco de destino. O comando básico — mongorestore –drop — remove coleções existentes antes de restaurar, o que elimina resíduos do banco corrompido, mas também apaga qualquer dado que tenha entrado depois do dump. Para bancos grandes, a opção –numInsertionWorkersPerCollection paraleliza a carga e reduz o tempo de indisponibilidade.

Dumps compactados em BSON.gz exigem descompressão durante a restauração, o que aumenta o uso de CPU mas reduz o espaço ocupado em disco. É fundamental validar a integridade do próprio dump antes de restaurar.

Replay de oplog para reduzir perda de dados

O oplog registra todas as operações de escrita em ordem, e é ele que permite recuperação point-in-time: restaura-se o dump e reaplica-se o oplog até o instante desejado. O comando mongorestore –oplogReplay automatiza esse processo quando o dump foi feito com –oplog, que captura as operações ocorridas durante o próprio backup.

O limite prático do replay é o tamanho do oplog: se o oplog foi rotacionado antes do incidente, as operações mais antigas não existem mais e não podem ser reaplicadas. Por isso, a janela de point-in-time é diretamente proporcional ao tamanho configurado do oplog — e inversamente proporcional ao volume de escritas do banco.

Backups de snapshot (EBS, LVM, filesystem) e como montá-los com segurança

Snapshots capturam o estado do volume em um instante, sem passar pelo mongodump. Para serem consistentes, precisam ser feitos com o banco em fsyncLock ou com o WiredTiger em checkpoint estável — caso contrário, o snapshot pode conter páginas no meio de uma escrita. Montar um snapshot inconsistente equivale a iniciar o MongoDB após uma queda de energia: o journal tenta recuperar, mas nem sempre consegue.

A restauração segura de snapshot exige montar o volume em um ambiente isolado, nunca sobre o volume de produção. Em nuvem, snapshots EBS devem ser restaurados como volumes novos e anexados a uma instância de teste antes de qualquer tentativa de iniciar o mongod. Para volumes locais, o mesmo princípio vale para LVM e para snapshots de filesystem — e a falha nesse cuidado é uma das causas mais frequentes de snapshot corrompido.

Blog — Empresa (A)

Recuperação sem backup: o que dá para salvar de um WiredTiger corrompido

Sem backup, a recuperação depende de extrair documentos diretamente dos arquivos .wt danificados. O WiredTiger armazena dados em formato proprietário com páginas comprimidas e checksums; quando uma página está íntegra, seus documentos podem ser lidos mesmo que outras partes do arquivo estejam corrompidas. A técnica consiste em percorrer o arquivo, validar cada página pelo checksum e extrair os documentos das páginas que passam na validação.

A taxa de sucesso varia conforme o padrão do dano: corrupção localizada em poucas páginas costuma preservar a quase totalidade dos documentos; corrupção generalizada por falha de disco pode reduzir a recuperação a frações. O fator decisivo é a qualidade da mídia no momento da extração — por isso a imagem forense mencionada no diagnóstico é pré-requisito, não opção.

  • Páginas com checksum válido: documentos extraíveis individualmente.
  • Páginas corrompidas isoladas: perda restrita a poucos documentos.
  • Arquivo .wt parcialmente ilegível: extração por varredura de padrões BSON.
  • Collection inteira inacessível: análise do arquivo de metadados do WiredTiger.
  • Journal íntegro: reaplicação de transações não consolidadas no checkpoint.

Ferramentas caseiras de recuperação de arquivos não entendem o formato WiredTiger e tendem a agravar o dano ao tentar “reparar” o que não reconhecem. A extração de documentos de arquivos .wt exige conhecimento do layout interno do WiredTiger — incluindo compressão snappy/zstd, formato de célula e estrutura de página — e é um trabalho de engenharia reversa, não de utilitário genérico.

Replica set, sharding e Atlas: o que muda na recuperação

Ambientes distribuídos mudam a natureza do problema. Em um replica set saudável, a corrupção de um nó é contornável: os demais membros mantêm cópias dos dados, e o nó corrompido pode ser reconstruído a partir de um secundário íntegro. Em sharding, a complexidade aumenta porque os metadados de distribuição vivem no config server — e a corrupção desses metadados afeta o cluster inteiro, não apenas um shard.

Serviços gerenciados como MongoDB Atlas limitam o acesso ao filesystem e ao motor de armazenamento, o que restringe drasticamente as opções de recuperação de baixo nível. O que seria um comando local em um servidor próprio vira um ticket de suporte em ambiente gerenciado — com prazos e limitações que nem sempre cabem na urgência de produção.

Reconstruir um nó corrompido a partir de um secundário saudável

O procedimento padrão é remover o nó corrompido do replica set, apagar o dbPath local e reiniciar o mongod vazio, deixando o initial sync copiar todos os dados do secundário saudável. O initial sync moderno copia arquivos e reaplica o oplog, resultando em um nó idêntico ao primário — sem intervenção manual nos dados. A condição é que ao menos um membro do set esteja íntegro e com oplog suficiente para cobrir o tempo de cópia.

Se todos os nós apresentarem corrupção simultânea — cenário comum em falha de storage compartilhado ou em ataque de ransomware — o replica set deixa de ser solução e vira parte do problema. Nesse caso, a recuperação precisa tratar cada nó como um banco independente e buscar o que há de íntegro em cada cópia, cruzando os resultados.

Shards com metadados corrompidos no config server

O config server guarda o mapeamento de chunks para shards. Se esses metadados corrompem, o cluster perde a capacidade de rotear consultas — mesmo que os dados em cada shard estejam intactos. A recuperação envolve restaurar o config server a partir de backup ou reconstruir o mapeamento a partir dos dados presentes nos shards, operação delicada que exige consistência entre o que o config server declara e o que os shards realmente contêm.

Erros de roteamento como chunk not found ou shard key out of range indicam divergência entre metadados e dados reais. Reconstruir esse mapeamento sem backup é uma das operações mais complexas em MongoDB — e uma das que mais se beneficia de diagnóstico especializado antes de qualquer escrita no cluster.

MongoDB Atlas e MongoDB Enterprise: limites do autoatendimento

No Atlas, o cliente não tem acesso ao dbPath, ao WiredTiger nem aos arquivos .wt — apenas à interface de gerenciamento e às APIs. Isso significa que as técnicas de extração direta de arquivos, de imagem forense e de reparo em nível de página simplesmente não estão disponíveis. A recuperação fica limitada a snapshots gerenciados, point-in-time restore dentro da janela contratada e suporte do provedor.

O MongoDB Enterprise oferece ferramentas adicionais como backup nativo e criptografia em repouso, mas não elimina a necessidade de diagnóstico correto. Criptografia em repouso, aliás, adiciona uma camada crítica: arquivos .wt corrompidos e criptografados não podem ser extraídos sem a chave — e a perda da chave transforma corrupção parcial em perda total. Em cenários de volume Btrfs com snapshots, a interação entre o filesystem e o banco exige cuidado redobrado.

Causas mais comuns de corrupção em MongoDB

Queda de energia ou desligamento abrupto sem journal habilitado — ou com journal em disco que também sofreu a interrupção — é uma causa recorrente. O WiredTiger usa checkpoint e journal para garantir consistência, mas se a escrita do checkpoint for interrompida no meio, o arquivo de dados pode ficar com páginas parcialmente gravadas. Fontes de alimentação instáveis em servidores físicos respondem por uma parcela significativa desses incidentes.

A segunda grande causa é falha de hardware de armazenamento: setores defeituosos em HD, desgaste de células em SSD, controladora RAID com cache sujo ou volume LVM montado sobre discos com erros. Nesses casos, o MongoDB é vítima, não origem — e qualquer tentativa de reparo pelo banco apenas multiplica as leituras sobre a mídia já degradada.

  • Queda de energia sem no-break: checkpoint interrompido no meio da escrita.
  • Falha de disco ou SSD: setores ilegíveis corrompem páginas do WiredTiger.
  • Erro humano: exclusão de arquivos do dbPath com o banco em execução.
  • Ransomware: criptografia parcial de arquivos .wt e de backups conectados.
  • Bug de driver ou aplicação: escrita malformada que viola estrutura BSON.
  • Migração ou upgrade interrompido: versão incompatível do formato de arquivo.

Ransomware merece destaque: ataques que criptografam o dbPath e os backups conectados ao mesmo volume transformam corrupção em sequestro de dados. A recuperação nesses casos passa por análise forense do que restou íntegro e, frequentemente, por negociação técnica com a extensão do dano — não com o atacante. A prevenção exige backups isolados, imutáveis e fora da rede de produção.

Como prevenir: validação, monitoramento e política de backup

Prevenção em MongoDB se apoia em três pilares: validação periódica, monitoramento preditivo e política de backup com teste de restauração. A validação periódica — rodar db.collection.validate() em janelas de manutenção — detecta corrupção silenciosa antes que ela se espalhe ou que o banco pare de subir. O monitoramento de SMART em discos, de erros de I/O no sistema e de métricas do WiredTiger captura a degradação do hardware antes da falha total.

A política de backup precisa responder a três perguntas: qual a janela de perda aceitável (RPO), quanto tempo a restauração pode levar (RTO) e onde o backup fica armazenado. Backups no mesmo volume do banco são inúteis contra falha de storage e contra ransomware. A prática recomendada combina dump lógico periódico, snapshot consistente e cópia externa — com teste de restauração agendado, porque backup que nunca foi restaurado é apenas uma promessa.

Quando o caso exige recuperação especializada em laboratório

O limite do autoatendimento é claro: quando o problema está no hardware, quando os arquivos .wt precisam de extração em nível de página ou quando tentativas anteriores já alteraram o estado original. Nesses cenários, cada nova ação sobre a mídia reduz a probabilidade de recuperação — e a decisão correta é interromper tudo e preservar o que existe.

Laboratórios de recuperação trabalham com sala limpa para discos abertos, leitura controlada de setores, equipamentos de imagem forense e conhecimento específico do formato WiredTiger. O trabalho combina duas disciplinas: recuperação de mídia física e engenharia reversa de banco de dados. É essa combinação que permite recuperar documentos de um MongoDB corrompido quando o disco não responde mais a leituras convencionais — situação análoga à de um RAID Drobo que não monta, onde o problema de storage precisa ser resolvido antes de qualquer questão de banco.

A decisão de enviar para laboratório deve considerar o valor dos dados, o custo da parada e o risco de agravamento. Bancos de produção com dados transacionais, coleções grandes e ausência de backup íntegro raramente se beneficiam de insistência local. O diagnóstico inicial — imagem do disco, análise do log e validação do WiredTiger — é o que informa essa decisão com base técnica, não em pânico.

Perguntas frequentes sobre recuperação de MongoDB corrompido

O comando mongod –repair resolve corrupção no WiredTiger?
O –repair tenta reconstruir arquivos danificados descartando o que não consegue validar. Ele pode recuperar parte dos dados, mas é destrutivo por natureza e nunca deve ser executado sobre a única cópia. A prática segura é rodar sobre uma réplica integral do dbPath, após imagem forense do original.

É possível recuperar dados de um MongoDB sem backup?
Sim, em muitos casos. Documentos em páginas íntegras do WiredTiger podem ser extraídos diretamente dos arquivos .wt, mesmo quando outras partes do arquivo estão corrompidas. O sucesso depende da extensão do dano e da preservação da mídia antes da tentativa.

O que fazer primeiro quando o mongod não sobe com erro WT_CORRUPTION?
Interromper qualquer nova tentativa de inicialização, preservar o estado atual do disco com imagem forense e analisar o log completo. Só depois de entender a extensão do dano é que se decide entre restaurar backup, extrair documentos ou acionar recuperação especializada.

Replica set protege contra corrupção de dados?
Protege contra falha de um nó, desde que os demais estejam íntegros. Se a corrupção decorre de falha de storage compartilhado, ransomware ou erro de aplicação replicado, todos os nós podem ser afetados simultaneamente — e o replica set deixa de ser proteção.

MongoDB Atlas garante recuperação de banco corrompido?
O Atlas oferece snapshots gerenciados e point-in-time restore dentro da janela contratada, mas não expõe acesso ao filesystem nem aos arquivos .wt. Para corrupção fora da janela de snapshot ou em cenários de criptografia, as opções de autoatendimento são limitadas.

Quanto tempo leva para recuperar um MongoDB corrompido?
O prazo só é estimável após a análise inicial da mídia e dos arquivos.

Blog — Empresa (A)