Banco HSQLDB Corrompido no Emissor SEBRAE: Como Recuperar

“Erro ao iniciar o banco de dados”, “ConnectionFailedException”, “Database file corrupted” — se você abriu o Emissor de Nota Fiscal SEBRAE hoje e viu uma dessas mensagens, o banco HSQLDB local está corrompido. É um dos problemas mais sérios e dolorosos do emissor, porque pode significar perda de histórico de NFs, cadastros e configurações.

A boa notícia: em ~85% dos casos é possível recuperar o banco sem perder dados. Vou explicar exatamente como — passo a passo, em 2026, com base em casos reais que já atendemos.

O que é o banco HSQLDB do Emissor SEBRAE

O Emissor SEBRAE usa um banco de dados embarcado chamado HSQLDB (HyperSQL Database) — um banco em Java que roda no próprio computador, sem servidor separado. Os arquivos ficam em:

• Windows: C:\Users\[seu_usuario]\.cache\nfe ou C:\Emissor\db
• Arquivos principais: nfe.script, nfe.properties, nfe.data, nfe.log, nfe.lck
• Arquivo crítico: nfe.script (estrutura) + nfe.data (dados)

Por que o banco HSQLDB corrompe

1. Desligamento abrupto: queda de energia, computador travado, fim de processo forçado durante gravação.
2. Falha de disco/SSD: setor com bad block bem onde está o arquivo .data.
3. Antivírus interferindo: alguns antivírus bloqueiam acesso ao .lck (lock file).
4. Múltiplas instâncias abertas: duas pessoas tentando acessar o mesmo banco em rede mal configurada.
5. Versão Java incompatível: rodar com Java muito antigo ou muito novo pode corromper.
6. Tamanho excessivo: banco com 3-5+ anos de NFs acumuladas fica frágil.

Sintomas de banco corrompido

• Emissor não abre — fica travado no splash screen ou fecha sozinho
• Erro “Database lock acquisition failure”
• Erro “Connection refused: database not started”
• Emissor abre mas mostra lista vazia de NFs
• Cadastros (clientes, produtos) sumiram
• Mensagem “java.sql.SQLException” no console
• Arquivo nfe.lck travado mesmo após fechar o emissor

Procedimento de recuperação — passo a passo

ATENÇÃO: antes de qualquer coisa, faça uma cópia completa da pasta do banco. Esse backup é seu salva-vidas se o procedimento der errado.

Passo 1: Backup integral

1. Feche o Emissor SEBRAE completamente (verifique no Gerenciador de Tarefas se algum processo “java” relacionado ainda está rodando — finalize).
2. Copie a pasta inteira do banco para uma localização segura (ex.: D:\backup_nfe_2026-05-30\).
3. Faça uma segunda cópia em pen drive ou cloud — redundância salva vidas.

Passo 2: Limpar o lock file

O arquivo nfe.lck é uma “trava” que indica que o banco está em uso. Se o emissor travou, o lock fica órfão e impede nova abertura.

1. Vá na pasta do banco.
2. Delete o arquivo nfe.lck (ou renomeie para nfe.lck.old).
3. Tente abrir o Emissor SEBRAE.
4. Se abrir normalmente, problema era só o lock — você está salvo. Faça backup imediatamente.

Passo 3: Reconstruir a partir do .log

Se o passo 2 não resolveu, o HSQLDB tem um sistema de replay que pode reconstruir o banco a partir do arquivo .log (transações não comitadas).

1. Renomeie o arquivo nfe.data para nfe.data.old
2. Renomeie nfe.properties para nfe.properties.old
3. Abra o emissor — ele tentará reconstruir
4. Se falhar, restaure os arquivos .old e siga para o passo 4

Passo 4: Recuperação via HSQLDB Tools

Procedimento avançado que exige conhecimento técnico — geralmente o ponto onde clientes nos chamam:

1. Instalar HSQLDB standalone (versão compatível com a versão usada no emissor)
2. Conectar via DatabaseManager no arquivo corrompido
3. Executar comando SCRIPT para gerar script de criação
4. Identificar onde está a corrupção (geralmente uma tabela específica)
5. Reconstruir o banco em arquivo novo, importando apenas os dados íntegros
6. Substituir os arquivos no Emissor SEBRAE

Passo 5: Recuperação via XMLs autorizados (último recurso)

Se nada acima funcionou, ainda há esperança: todas as NF-e autorizadas ficam disponíveis no portal nacional da NF-e. Você pode:

1. Acessar https://www.nfe.fazenda.gov.br com seu certificado A1 ou A3
2. Baixar todas as NFs emitidas no período
3. Reinstalar o emissor com banco zerado
4. Importar XMLs de volta (recadastrando clientes/produtos a partir deles)

Esse processo é trabalhoso (dias de trabalho), mas garante histórico fiscal completo para auditoria.

Como evitar que o banco corrompa de novo

• Backup diário automático: configure script que copia a pasta do banco para outro local todo dia.
• No-break (UPS): previne queda de energia — investimento de R$ 250-R$ 500 que paga sozinho.
• Antivírus com exceção: adicione a pasta do banco como exceção do antivírus.
• Não use o banco em rede: HSQLDB não suporta multi-usuário. Para isso, migre para emissor profissional.
• Arquivamento anual: a cada 12-18 meses, gere backup compactado e limpe NFs muito antigas (após validar que estão no portal).
• Atualize Java: mantenha JRE 8 ou superior, 64 bits, sem versões conflitantes instaladas.

Quando chamar suporte especializado

Se você chegou até o passo 3 e ainda não conseguiu, é hora de chamar um técnico. O passo 4 (HSQLDB tools) exige conhecimento de SQL, Java e estrutura interna do emissor. Tentar sem experiência pode destruir definitivamente o banco.

A Agência MZ recupera banco HSQLDB corrompido em ~85% dos casos atendidos. Atendimento presencial em Tatuí, Sorocaba e região, ou remoto via AnyDesk. Tempo médio de recuperação: 2-6 horas. Custo: R$ 600 a R$ 1.800 dependendo da complexidade.

Veja outras situações que resolvemos na página completa de suporte ao Emissor SEBRAE.

FAQ: banco HSQLDB corrompido

Vou perder todas as minhas NFs e cadastros?

Não necessariamente. Em ~85% dos casos recuperamos tudo. No pior cenário, NFs autorizadas estão sempre no portal nacional — só os cadastros (clientes, produtos) precisam ser reconstruídos.

Posso só “começar de zero”?

Pode, mas perde histórico para auditoria fiscal. Recomendamos sempre tentar recuperação primeiro. Começar do zero deve ser último recurso.

Quanto tempo demora a recuperação profissional?

Passo 2 (lock): 5 minutos. Passo 3 (reconstrução): 30-60 minutos. Passo 4 (HSQLDB tools): 2-6 horas. Passo 5 (XMLs): 1-3 dias.

O suporte do SEBRAE recupera?

Em 2026, o suporte oficial do SEBRAE ao emissor é limitado. Geralmente direcionam para reinstalação (perdendo tudo). Por isso a recuperação técnica especializada virou um nicho importante.

Como evito que aconteça de novo?

Backup automático diário + no-break + antivírus com exceção + arquivamento anual. Implementamos isso em todos os clientes do plano de suporte mensal.

Próximo passo

Se seu banco está corrompido agora, fale conosco antes de tentar passos arriscados. Atendimento de emergência por WhatsApp.