Banco de dados

Como recuperar um banco de dados Firebird corrompido?

Caio
21 min de leitura

O servidor Firebird começou a recusar conexões, o gbak não termina e a aplicação parou de responder. Antes de sair rodando comandos de reparo, é preciso saber o que está realmente acontecendo com o arquivo. Este guia mostra como diagnosticar a falha, preservar o original e conduzir a recuperação de um banco de dados Firebird corrompido com ferramentas nativas e extração de dados, sem transformar um incidente contornável em perda definitiva.

O que significa um banco Firebird corrompido e o que ainda dá para salvar

Um banco Firebird corrompido é um arquivo .FDB (ou .GDB em versões antigas) cuja estrutura interna deixou de ser consistente com o que o motor do banco espera encontrar. Isso pode envolver páginas de dados com checksum inválido, ponteiros que apontam para endereços inexistentes, cabeçalhos de transação truncados ou índices que referenciam registros apagados. Diferente de uma falha de hardware em HD ou SSD, a corrupção lógica de um Firebird raramente destrói os dados de forma física imediata — na maioria dos cenários, os registros ainda estão gravados no arquivo, mas o banco perdeu a capacidade de localizá-los e interpretá-los de forma segura.

O que se consegue salvar depende de três fatores: o tipo de corrupção (estrutural, de índice ou de cabeçalho), a extensão do dano e, principalmente, se houve tentativas de reparo mal conduzidas antes do diagnóstico. Bancos com corrupção restrita a índices secundários podem ser recuperados integralmente com backup lógico e restauração. Já arquivos com páginas de dados sobrescritas por defeito físico no disco ou por gravação parcial durante queda de energia podem exigir extração página a página, com perda limitada a transações que estavam em voo no momento do incidente. A regra prática é: quanto menos o arquivo original for alterado antes do diagnóstico, maior a janela de recuperação.

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 .FDB

O Firebird costuma sinalizar corrupção por meio de mensagens específicas no log do servidor, no console do isql ou na aplicação cliente. Os sintomas mais comuns incluem:

  • Falha ao conectar com “database file appears corrupt”
  • Erro de checksum em página de dados ou índice
  • Mensagem “invalid page type” ou “page xxx is of wrong type”
  • Queda do servidor Firebird logo após iniciar uma consulta específica
  • Lentidão extrema seguida de erro de I/O em tabelas específicas
  • Impossibilidade de executar backup com gbak até o final

Nem todo erro de acesso é corrupção. Um banco pode recusar conexão por lock de processo, falta de permissão no diretório ou arquivo em uso por outro serviço — e confundir esses cenários com corrupção leva a reparos desnecessários que podem piorar o quadro. Por isso, o primeiro passo de qualquer diagnóstico é separar falha de integridade de falha de ambiente.

Erros de checksum, página inválida e “database file appears corrupt”

A mensagem “database file appears corrupt” aparece quando o Firebird não consegue validar o cabeçalho do banco ou quando a primeira página de dados falha na verificação de integridade. O erro de checksum, por sua vez, indica que o conteúdo gravado em uma página não corresponde à soma de verificação calculada no momento da escrita — sinal clássico de gravação parcial, corrupção por queda de energia ou interferência de antivírus no arquivo.

Páginas marcadas como “wrong page type” apontam para dessincronização entre o que o motor espera encontrar em um endereço físico e o que realmente está lá. Isso ocorre quando o sistema de arquivos entrega dados de outra região do disco, quando há bad blocks no storage ou quando o banco foi copiado enquanto estava aberto. Em todos esses casos, o arquivo original deve ser preservado antes de qualquer comando de reparo.

Quando o problema é corrupção e quando é arquivo travado, lock ou falta de permissão

Um banco Firebird pode recusar conexão com mensagens como “I/O error during ‘open’ operation”, “unavailable database” ou “lock conflict on no wait transaction” sem que haja qualquer corrupção interna. O teste mais rápido é verificar se o processo do servidor Firebird está ativo, se o arquivo .FDB não está aberto por outro aplicativo (inclusive um backup em andamento) e se a conta de serviço tem permissão de leitura e escrita no diretório.

Outra situação recorrente é o lock file (.lck) remanescente após uma queda abrupta do servidor. Em versões Classic ou SuperClassic, um arquivo de lock órfão pode impedir novas conexões mesmo com o banco íntegro. A remoção desse arquivo só deve ser feita com o servidor parado e após confirmar que nenhum processo mantém o banco aberto — nunca como primeira ação diante de suspeita de corrupção.

Antes de qualquer comando: como preservar o arquivo original e o que nunca fazer

A sequência de ações nas primeiras horas define o limite do que será possível recuperar. O procedimento correto começa com a cópia fria do arquivo original, byte a byte, com o serviço do Firebird completamente parado. Essa cópia deve ser feita em outro dispositivo físico — nunca no mesmo disco do banco corrompido — e idealmente com verificação de integridade da cópia (hash ou comparação de tamanho) antes de prosseguir.

O que nunca fazer diante de um .FDB corrompido:

  • Não executar gfix -mend diretamente no arquivo original sem cópia prévia
  • Não apagar arquivos .lck, .tmp ou .delta por tentativa e erro
  • Não copiar o banco com o servidor em execução ou com usuários conectados
  • Não rodar sweep, backup ou restore sobre o único arquivo existente
  • Não permitir que antivírus ou ferramenta de “limpeza” altere o .FDB
  • Não restaurar um backup antigo por cima do banco corrompido antes do diagnóstico

Cada tentativa de reparo mal planejada reescreve páginas do arquivo e pode destruir registros que ainda estavam íntegros. O princípio é o mesmo adotado em recuperação de servidores de arquivos após incidentes de integridade: trabalhar sempre sobre cópia, nunca sobre o original, e registrar cada comando executado para permitir reversão do raciocínio.

Diagnóstico com gfix: validação, sweep e leitura do log de erros

O gfix é a ferramenta nativa de manutenção do Firebird e o ponto de partida de qualquer diagnóstico. Ele opera em dois modos principais: validação (somente leitura, não altera dados) e reparo (modifica o arquivo). O diagnóstico correto exige começar pelo modo de leitura, interpretar a saída e só então decidir se há espaço para reparo ou se o caminho é extração de dados.

Antes de rodar qualquer validação, é essencial garantir que o banco esteja offline ou em modo de manutenção exclusiva. Rodar gfix com usuários conectados produz falsos positivos e pode mascarar ou agravar a corrupção real.

gfix -validate e -full: o que cada modo verifica

O comando gfix -validate percorre a estrutura do banco verificando consistência de páginas, checksums, ponteiros de índices e integridade das transações registradas. O parâmetro -full amplia a checagem para todas as páginas de dados e todos os registros, incluindo verificação de fragmentação e consistência de versões de registro — é mais lento, porém mais abrangente.

A validação sem -full pode não encontrar corrupção em páginas de dados que não pertencem a índices ativos. Por isso, diante de sintomas claros (erro em consulta específica, falha de backup), o procedimento recomendado é rodar primeiro o validate padrão e, se ele não apontar nada, executar o -full antes de concluir que o banco está íntegro.

Interpretando a saída e decidindo entre reparo e extração

A saída do gfix -validate lista erros por tipo: checksum error, page type error, orphan page, index root page is wrong, entre outros. A decisão entre reparo e extração segue uma hierarquia de risco:

  • Erros restritos a índices secundários: backup lógico costuma resolver
  • Erros de checksum em páginas de dados isoladas: mend pode recuperar, com perda pontual
  • Erros em páginas de cabeçalho ou de transação: risco alto de perda ampla no mend
  • Grande volume de páginas órfãs ou wrong page type: extração página a página é mais seguro

Regra prática: se a corrupção compromete estruturas centrais (cabeçalho, páginas de ponteiro, transação ativa), o reparo direto tende a reescrever mais do que recupera. Nesses casos, a extração dos dados por ferramenta especializada — ou por leitura de páginas com parser próprio — preserva mais registros do que insistir no gfix.

Recuperação passo a passo com gfix e gbak

Quando o diagnóstico indica corrupção contida, o fluxo clássico de recuperação combina gfix -mend para corrigir estruturas danificadas e gbak para gerar um backup lógico que será restaurado em um banco novo. A ordem importa: nunca restaurar por cima do arquivo corrompido; sempre gerar um .FBK e restaurá-lo em um .FDB recém-criado.

O procedimento completo, em linhas gerais:

  1. Parar o serviço Firebird e fazer cópia fria do .FDB original
  2. Rodar gfix -validate -full na cópia para mapear os erros
  3. Aplicar gfix -mend em nível progressivo, se indicado
  4. Gerar backup lógico com gbak -b
  5. Restaurar o .FBK em um banco novo com gbak -c
  6. Validar o banco restaurado antes de liberar para produção

Reparo direto com gfix -mend e seus níveis

O gfix -mend tenta corrigir erros estruturais reescrevendo páginas danificadas. Ele aceita níveis de agressividade, do mais conservador (corrigir apenas o que é inequívoco) ao mais invasivo (marcar páginas como corrompidas e removê-las da árvore de alocação). Cada nível destrói uma quantidade de dados que não pode ser recuperada depois — por isso a progressão deve ser lenta e sempre sobre cópia.

O risco do mend é a falsa correção: o comando pode “consertar” um ponteiro apontando para uma página errada sem perceber que a página correta existe em outro endereço, efetivamente perdendo os registros que estavam lá. Em bancos com corrupção extensa, o mend tende a produzir um arquivo que abre, mas com sumiço de tabelas inteiras — o pior desfecho possível, porque mascara a perda.

Backup lógico com gbak -b e restauração em banco novo

O gbak -b gera um backup lógico que lê os dados por meio do motor do Firebird, não copia o arquivo físico. Isso permite contornar corrupção de índices e de páginas de alocação: o backup reconstrói a estrutura a partir dos registros que ainda são legíveis.

A restauração deve ser feita com gbak -c em um arquivo novo, nunca sobre o original. Após restaurar, é obrigatório rodar gfix -validate no banco novo e testar a integridade das tabelas críticas antes de colocar o sistema em produção. Um backup que gera com sucesso não garante, por si só, que todos os registros foram extraídos — a validação pós-restore é o único teste confiável.

gfix -shut, -online e ajuste de modo forced writes antes de reabrir

O gfix -shut coloca o banco em modo de desligamento controlado, impedindo novas conexões e permitindo manutenção exclusiva. O parâmetro -force encerra transações ativas após um tempo limite — útil quando há conexões penduradas impedindo o acesso. Após o reparo, o gfix -online reativa o banco para conexões normais.

Antes de reabrir para os usuários, é recomendável ativar o forced writes (gravação síncrona) na configuração do banco. Essa configuração obriga o Firebird a gravar cada página no disco antes de confirmar a transação. O custo é uma pequena redução de desempenho em escrita, irrelevante diante do ganho de integridade em ambientes sem nobreak.

Blog — Empresa (A)

Quando o gfix não resolve: extração de dados e ferramentas especializadas

Há um limite claro para o que gfix e gbak conseguem fazer. Quando o cabeçalho do banco está destruído, quando páginas de dados foram sobrescritas ou quando o arquivo apresenta corrupção física no storage, a saída é a extração direta dos dados por leitura de baixo nível — sem depender do motor do Firebird para interpretar o arquivo.

Esse tipo de trabalho é análogo ao que se faz na recuperação de bancos SQL Server corrompidos ou de tabelas MySQL após falha estrutural: em vez de confiar no SGBD, o especialista lê o arquivo página a página, identifica os registros pelos padrões de cabeçalho de cada página e remonta as tabelas manualmente.

Extração de dados página a página e recuperação de registros órfãos

A extração página a página parte do princípio de que cada página de dados do Firebird tem um cabeçalho próprio com tipo de página, sequência e ponteiros. Mesmo quando o dicionário de dados (tabelas de sistema) está corrompido, os registros de usuário continuam gravados nas páginas de dados com marcadores de tipo e tamanho. Um parser especializado consegue varrer o arquivo, identificar essas páginas e extrair os registros mesmo sem o catálogo.

Os registros órfãos são aqueles que perderam o vínculo com o índice ou com a tabela de origem — o banco não os enxerga mais, mas os bytes continuam no arquivo. A recuperação desses registros exige mapear as páginas de dados e reconstruir a relação entre elas a partir dos ponteiros internos, tarefa que o gfix não executa e que o gbak só alcança se o dicionário estiver íntegro. Em casos de corrupção severa, é justamente essa camada de registros órfãos que contém os dados mais valiosos.

Ferramentas comerciais de recuperação Firebird e o que avaliar antes de escolher

Existem utilitários comerciais capazes de abrir arquivos .FDB corrompidos e extrair tabelas sem passar pelo motor do Firebird. Antes de escolher uma ferramenta, avalie:

  • Se ela lê o arquivo em modo somente leitura, sem modificar o original
  • Se suporta a versão específica do Firebird (ODS do arquivo)
  • Se permite exportar os dados em formato utilizável (CSV, SQL, tabela a tabela)
  • Se lida com páginas de dados danificadas sem abortar a extração inteira
  • Se há histórico de uso em bancos com corrupção de cabeçalho e de dicionário

O risco de ferramentas caseiras ou de versões de teste é a escrita acidental no arquivo original durante a análise. Qualquer utilitário que abra o .FDB em modo leitura-escrita pode agravar a corrupção de forma irreversível. A regra é a mesma do gfix: trabalhar apenas sobre cópia, e de preferência com ferramenta que tenha modo estrito de somente leitura.

Cenários comuns de corrupção em Firebird e como agir em cada um

Cada causa de corrupção deixa um padrão característico no arquivo, e reconhecer esse padrão orienta a estratégia de recuperação. Os três cenários mais frequentes em ambientes de produção são queda de energia, mudança de versão ou arquitetura e problemas de infraestrutura de rede ou backup.

Queda de energia e desligamento abrupto do servidor

Quando o servidor cai sem desligamento controlado, as transações que estavam em memória mas ainda não haviam sido gravadas em disco se perdem, e páginas podem ficar gravadas pela metade. O resultado típico é erro de checksum em páginas de dados e ponteiros de transação inconsistentes. Nesse cenário, o backup lógico com gbak -b -g costuma recuperar a maior parte dos dados, porque a corrupção tende a se concentrar nas transações em voo.

A prevenção passa por forced writes ativado e nobreak com desligamento automático. Em ambientes sem nobreak, o forced writes é a diferença entre perder apenas a última transação e perder blocos inteiros de dados gravados de forma assíncrona.

Corrupção após atualização de versão ou troca de arquitetura (32/64 bits)

Atualizar o Firebird de uma versão para outra sem passar pelo processo correto de backup e restauração pode deixar o banco em um ODS (On-Disk Structure) incompatível com o novo motor. O sintoma clássico é o banco abrir em versões antigas e falhar na nova, ou apresentar erros intermitentes de página após a migração. A troca de arquitetura 32 para 64 bits, por si só, não corrompe o arquivo — mas a combinação de versões diferentes de motor acessando o mesmo .FDB pode.

O caminho seguro de migração é sempre backup lógico na versão antiga e restauração na versão nova, nunca a simples substituição do executável do servidor sobre um banco existente. Se a corrupção já aconteceu após uma migração mal feita, a prioridade é voltar ao ambiente antigo, gerar o backup lógico de lá e só então migrar pelo caminho formal.

Arquivo em rede, antivírus e backup copiado com o banco aberto

Manter o .FDB em compartilhamento de rede (SMB/CIFS) é uma das causas mais subnotificadas de corrupção em Firebird. O protocolo de rede pode reordenar ou perder gravações, e qualquer oscilação na conexão entre o servidor e o storage deixa páginas gravadas de forma incompleta. O Firebird oficialmente desaconselha bancos em compartilhamento de rede por esse motivo.

O antivírus é outro agente silencioso: scanners em tempo real que inspecionam o .FDB durante gravações intensas podem atrasar ou bloquear escritas, gerando checksums inválidos. E o backup copiado com o banco aberto — prática comum de “copiar o .FDB para o HD externo” sem parar o serviço — produz um arquivo inconsistente que parece íntegro, mas falha na validação. A regra é simples: cópia física só com o banco parado; em operação, apenas backup lógico com gbak.

Recuperação de backup corrompido ou incompleto

Quando o arquivo .FDB original foi perdido e o único recurso disponível é um backup .FBK corrompido ou truncado, a recuperação muda de natureza. Nesses casos, é preciso reconstruir o backup ou extrair os dados diretamente do .FBK.

O formato .FBK é uma sequência de comandos de criação e inserção em formato proprietário. Um backup truncado pode conter a maior parte das tabelas e dos registros antes do ponto de falha, e ferramentas de parse conseguem ler até onde o arquivo está íntegro. A recuperação de um .FBK corrompido segue a mesma lógica da recuperação de snapshots de NAS corrompidos: aproveitar ao máximo o que está legível e reconstruir o restante por leitura direta.

Se o backup foi gerado com gbak -b em modo transportável, a estrutura interna permite extração parcial mesmo sem o banco original. A recomendação é nunca tentar “consertar” o .FBK editando-o manualmente ou reexecutando comandos fora de ordem — isso corrompe ainda mais o arquivo. O caminho técnico é parsear o backup, extrair as tabelas completas até o ponto de falha e, se necessário, complementar com extração do .FDB original, caso ele ainda exista em algum storage.

Como evitar nova corrupção: rotina de validação, backup e configuração

A prevenção de corrupção em Firebird se apoia em três pilares: validação periódica, backup testado e configuração adequada do servidor. A validação mensal com gfix -validate -full detecta corrupção silenciosa antes que ela se espalhe, enquanto o backup lógico diário com gbak -b garante um ponto de retorno recente.

O erro mais comum é gerar backups sem nunca testar a restauração. Um backup só é confiável se já foi restaurado com sucesso em ambiente de teste pelo menos uma vez. A rotina mínima recomendada inclui:

  • Backup lógico diário automatizado
  • Teste de restauração semanal em banco descartável
  • Validação mensal com gfix -validate -full
  • Forced writes ativado em todos os bancos de produção
  • Exclusão do diretório de dados do antivírus em tempo real
  • Nobreak com desligamento automático no servidor

A configuração do servidor também importa: bancos em storage local com sistema de arquivos confiável, sem compartilhamento de rede, e com espaço livre suficiente para o arquivo crescer sem fragmentação extrema. A combinação dessas práticas reduz drasticamente a incidência de corrupção, mas não a elimina — por isso o plano de recuperação precisa existir antes do incidente, não depois.

O que define o custo de uma recuperação de banco Firebird

O custo de uma recuperação de banco Firebird não segue tabela fixa, porque cada caso combina variáveis diferentes. Os fatores que mais pesam são:

  • Extensão da corrupção: índices isolados custam menos que dicionário de dados destruído
  • Necessidade de extração página a página versus backup lógico simples
  • Tamanho do banco e volume de registros a processar
  • Urgência: recuperação em fim de semana ou madrugada tem custo distinto
  • Existência de backup válido que reduza o escopo do trabalho
  • Necessidade de tratamento de mídia física (bad blocks, falha de storage)

Casos que exigem leitura de baixo nível, reconstrução de dicionário ou recuperação de registros órfãos demandam mais horas de engenharia e, portanto, custam mais do que um simples backup lógico seguido de restauração. O orçamento só pode ser fechado após o diagnóstico inicial, que mapeia o tipo de corrupção e o caminho técnico necessário. A transparência nesse diagnóstico é o que separa um serviço técnico sério de uma promessa genérica de “recuperação garantida” — promessa que, em recuperação de dados, não existe.

Perguntas frequentes sobre recuperação de banco Firebird corrompido

É possível recuperar 100% dos dados de um banco Firebird corrompido?
Depende do tipo e da extensão da corrupção. Em casos de corrupção restrita a índices ou com backup lógico viável, a recuperação pode ser integral. Em corrupção severa de cabeçalho ou de páginas de dados, pode haver perda de transações que estavam em andamento no momento da falha. Nenhum serviço técnico sério promete recuperação garantida.

Rodar gfix -mend resolve a maioria dos casos?
Não. O gfix -mend é útil em corrupção contida, mas em danos extensos ele tende a reescrever estruturas e mascarar perdas. O diagnóstico com gfix -validate -full deve sempre preceder qualquer decisão de reparo, e o mend só deve ser executado sobre cópia do arquivo original.

Quanto tempo leva uma recuperação de banco Firebird?
Casos simples, com backup lógico possível, podem ser resolvidos em horas. Extração página a página ou reconstrução de dicionário pode levar dias, dependendo do tamanho do banco e do volume de registros órfãos. O prazo só é estimável após o diagnóstico inicial.

Posso continuar usando o banco enquanto ele apresenta erros intermitentes?
Não. Cada nova transação sobre um banco com corrupção ativa pode agravar o dano e reduzir a janela de recuperação. O correto é interromper o uso, fazer cópia fria do arquivo e iniciar o diagnóstico imediatamente.

Backup copiado com o banco aberto serve para recuperação?
Raramente. Uma cópia física feita com o banco em operação produz um arquivo inconsistente, que falha na validação e pode não abrir no Firebird. O backup confiável é o lógico, gerado com gbak, ou a cópia fria com o serviço parado.

Blog — Empresa (A)