How-to3 min de leitura

O arquivo não abre: Get Info, Repair e pare de adivinhar

Quando um PDF não abre, rode o Get Info e depois o Repair para reconstruir a estrutura. É recuperação de xref, não um clone do Recovery Toolbox para desktop.

By the PDF123 team · Updated 2026-10-04
O arquivo não abre: Get Info, Repair e pare de adivinhar

Um PDF que não abre costuma ter um problema de estrutura (tabela de referência cruzada quebrada, download truncado, objetos malformados), e não uma imagem de página faltando que você poderia redesenhar à mão. Adivinhar com OCR, compress ou convert só gasta tempo enquanto o arquivo não pode ser interpretado.

Primeiro o Get Info

O Get Info (POST /api/v1/security/get-info-on-pdf) devolve um relatório em JSON: FileSize, PageCount, Encrypted, campos do dicionário Info quando existem (title, author, subject, creator, producer), a Version do PDF, uma lista simples em Pages e a informação de se a raiz do documento foi encontrada. Use-o como verificação prévia:

  • Encrypted: true significa que você precisa de um Desbloquear autorizado antes da maioria das edições; o reparo sozinho não quebra senhas.
  • PageCount / FileSize parecem razoáveis, mas o seu visualizador de desktop ainda falha: tente o Repair estrutural em seguida.
  • A própria chamada não consegue carregar os bytes: o arquivo pode estar danificado demais para um Get Info limpo; mesmo assim, tente o Repair numa cópia.

O Get Info não reescreve o PDF. Ele informa o que o interpretador consegue enxergar, para você parar de tratar toda falha como "precisa de OCR" ou "precisa de compress".

Depois o Repair (reconstrução estrutural com qpdf)

O Repair PDF (POST /api/v1/misc/repair) reescreve o arquivo com o qpdf, para que os visualizadores voltem a abri-lo quando restam objetos suficientes. Quando dá certo, o conteúdo pretendido das páginas é preservado; o trabalho é sobre o mapa do arquivo (xref e object streams), não sobre recuperação forense de rascunhos apagados.

O Repair não é:

  • OCR nem limpeza de digitalização (o arquivo abre, mas o texto é só imagem): use o OCR, que aqui devolve texto em Markdown, não uma camada pesquisável em PDF
  • Remoção de senha: use o Desbloquear
  • Reparo de fonte ou "tornar o arquivo editável de novo"
  • Um clone do produto para Windows chamado "Recovery Toolbox for PDF"

Para a diferença de marca e de canal (reparo estrutural online contra buscas por "recovery toolbox" para desktop), leia Reparar PDF online vs buscas por Recovery Toolbox.

Árvore de decisão para parar de adivinhar

  1. O visualizador não abre o arquivo: Get Info e depois Repair.
  2. O arquivo abre, mas selecionar e buscar falham numa digitalização: OCR para obter texto em Markdown; opcionalmente Comprimir uma cópia se o tamanho for o problema que resta (Pacote de digitalização: OCR e depois compressão).
  3. O arquivo abre e a exportação de tabelas devolve 204: nenhuma coluna detectada; veja Exportação de tabela vazia (204).
  4. O mesmo reparo a partir de um script ou agente: POST /api/v1/misc/repair via Desenvolvedores. Envie um Idempotency-Key se o seu cliente repetir uploads (Idempotency-Key).

O que “reparado” ainda não conserta

Um Repair bem-sucedido significa que o visualizador consegue abrir o arquivo outra vez. Não significa que:

  • Toda imagem de página foi reconstruída do nada (os objetos que faltam continuam faltando)
  • O texto ficou selecionável numa digitalização (isso é OCR → Markdown, aqui)
  • A criptografia desapareceu (isso é o Desbloquear, com a senha conhecida)
  • As tabelas vão exportar (ainda é preciso texto em colunas; 204 quer dizer que nenhuma foi detectada)

Se o Get Info mostra uma contagem de páginas razoável depois do Repair, mas uma página está em branco, a estrutura foi recuperada e mesmo assim o conteúdo daquela página pode continuar vazio ou truncado nos bytes originais.

Guarde o original danificado

Mantenha o original danificado ao lado de qualquer derivado reparado. Se o Repair não recuperar estrutura suficiente, o desfecho honesto é "os bytes se perderam", e não outra ferramenta qualquer do catálogo. Comprimir ou converter um arquivo que ainda não pode ser interpretado não inventa os objetos que faltam.

Compare a intenção de cada canal (reparo estrutural online contra buscas por marcas de "recovery toolbox" para desktop) em Reparar PDF online vs buscas por Recovery Toolbox, caso tenha sido assim que você encontrou a ferramenta. O caminho pelo navegador não exige conta nas ferramentas do catálogo.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool