Converter Base64 para PDF e arquivo · PDF para Base64

Base64 para PDF — respostas rápidas

O que é um PDF em Base64?

%PDF-1.4          → bytes 25 50 44 46 2D 31 2E 34
JVBERi0xLjQ=      → the same bytes in Base64
data:application/pdf;base64,JVBERi0xLjQ=   → data URI form

Recursos

Base64 para PDF em Python, Java, JavaScript e mais

Exemplos de Base64 para PDF

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4K…

PDF · versão 1.4 · baixado como file.pdf

"data:application\/pdf;base64,JVBERi0xLjQK…"

Interpretado assim: aspas removidas → escapes JSON desfeitos → prefixo data URI removido (application/pdf)

{"code":0,"data":{"name":"invoice.pdf","file":"JVBERi0xLjQK…"}}

Interpretado assim: campo data.file extraído do JSON

data:application/pdf;base64,iVBORw0KGgoAAAANSUhEUgAA…

Aviso: a data URI diz application/pdf, mas os bytes são PNG. Salvo como file.png

255044462d312e370a…

Aviso: isto parece hexadecimal; lido como hex, é um PDF. [Decodificar como hex]

Como converter Base64 para PDF

1. 1

   Cole o Base64 do jeito que você recebeu

   Base64 puro, data:application/pdf;base64,…, uma string copiada de um JSON com escapes \/ ou a resposta inteira da API. Para strings muito longas, use Abrir um arquivo .txt em vez de colar.

2. 2

   Confira como ele foi interpretado

   A linha abaixo da caixa lista cada etapa de limpeza: prefixo removido, escapes desfeitos, padding adicionado, campo extraído do JSON. Se algo estiver errado, o erro aponta o caractere exato e a posição.

3. 3

   Veja o tipo detectado e os avisos

   O selo mostra o tipo lido dos bytes mágicos do arquivo. Aparece uma nota amarela se na verdade não for um PDF, se a data URI mentir sobre o tipo ou se o PDF estiver cortado antes de %%EOF.

4. 4

   Visualize e baixe

   PDFs abrem no visualizador do próprio navegador; imagens e texto aparecem na página. Renomeie o arquivo se quiser e clique em Baixar. Para o sentido inverso, mude para PDF / arquivo → Base64 e solte um arquivo.

Por que um PDF em Base64 não abre: erros comuns

base64.b64decode(value)  # value = 'data:application/pdf;base64,JVBERi0…'

b64 = value.split(',', 1)[1] if value.startswith('data:') else value
pdf = base64.b64decode(b64)

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64').toString())

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64'))

byte[] pdf = Base64.getDecoder().decode(wrapped);  // IllegalArgumentException

byte[] pdf = Base64.getMimeDecoder().decode(wrapped);

base64.b64decode(token_part)  # contains - and _

base64.urlsafe_b64decode(token_part + '=' * (-len(token_part) % 4))

new Blob([atob(b64)], { type: 'application/pdf' })

const bytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0));
new Blob([bytes], { type: 'application/pdf' })

SELECT LENGTH(pdf_b64) FROM docs;  -- 65535: suspiciously round

ALTER TABLE docs MODIFY pdf_b64 LONGTEXT;  -- or store the bytes in a BLOB

Quando converter Base64 para PDF

Uma API devolve o PDF em Base64

APIs de emissão de notas, assinatura eletrônica e impressão de etiquetas costumam devolver documentos dentro de um JSON. Cole a resposta para conferir o documento antes de escrever o código que o salva.

Depurar um PDF que não abre

Quando o arquivo salvo sai em branco ou corrompido, cole aqui o mesmo Base64. A ferramenta diz se ele está truncado, codificado duas vezes, se nem é um PDF ou se está tudo certo, o que significa que o bug está na forma como seu código grava o arquivo.

Enviar um arquivo numa requisição JSON

Muitos endpoints de upload esperam {"filename": …, "content": "<base64>"}. Codifique o arquivo aqui para montar uma requisição de teste no Postman ou no cURL.

Incorporar um arquivo em HTML, CSS ou e-mail

Gere uma data URI para um link de PDF inline, uma fonte ou uma imagem pequena, ou Base64 com 76 colunas para uma parte MIME de e-mail.

Recuperar anexos de logs e bancos de dados

Arquivos guardados numa coluna de texto ou impressos num log podem ser extraídos direto, e a falta do %%EOF mostra que a coluna ou a linha de log era curta demais.

Como funciona a codificação Base64 de arquivos

Por que o Base64 é 33% maior

Cada caractere carrega 6 bits, então 3 bytes (24 bits) precisam de 4 caracteres. Com padding, o tamanho é 4 × ⌈n ÷ 3⌉: 100 KB (102.400 bytes) viram 136.536 caracteres. A quebra MIME adiciona um CRLF a cada 76 caracteres, então 1 MB vira 1.434.896 caracteres em vez de 1.398.104.

Alfabeto padrão e alfabeto URL-safe

A RFC 4648 define dois alfabetos que só diferem nos dois últimos caracteres: + / (padrão, seção 4) e - _ (seguro para URL e nome de arquivo, seção 5). O Base64 URL-safe costuma omitir o padding =. Se uma string mistura os dois, ela foi editada ou juntada de duas fontes.

Padding e tamanhos impossíveis

O padding = deixa o tamanho múltiplo de 4. Sem ele, um resto de 2 ou 3 pode ser restaurado; um resto de 1 é impossível para qualquer Base64 válido: um caractere foi perdido ou acrescentado. Um = no meio geralmente indica que duas strings foram concatenadas.

Os bytes mágicos definem o tipo

Um arquivo declara o formato nos primeiros bytes: %PDF- para PDF, 89 50 4E 47 para PNG, 50 4B 03 04 para formatos baseados em ZIP como DOCX e XLSX. Esses bytes fixam os primeiros caracteres do Base64, então dá para saber o tipo antes de decodificar: veja a tabela na ferramenta.

Como um PDF truncado é detectado

Um PDF termina com %%EOF. Se ele não aparece nos últimos 1.024 bytes, o arquivo quase certamente foi cortado. O cabeçalho pode começar até 1.024 bytes adiante; a maioria dos leitores ainda abre esses arquivos, então isso é avisado, mas não rejeitado.

Boas práticas para enviar arquivos em Base64

Envie o tipo MIME e o nome do arquivo junto com os dados

Base64 não carrega nome nem tipo. Coloque os dois ao lado ({"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}) ou use uma data URI, para quem recebe não precisar adivinhar.

Confira os bytes mágicos no lado que recebe

Antes de salvar, verifique se os bytes decodificados começam com %PDF-. Uma linha de código pega campo errado, codificação dupla e páginas de erro devolvidas em Base64.

Para arquivos grandes, prefira multipart ou uma URL

Base64 aumenta o tamanho em um terço e a string inteira precisa ficar na memória. Acima de alguns megabytes, multipart/form-data ou uma URL de download pré-assinada é mais leve para os dois lados.

Guarde bytes, não Base64, no banco de dados

Uma coluna BLOB/bytea ocupa um terço a menos e não pode ser truncada sem aviso como um VARCHAR. Codifique em Base64 só na fronteira da API.

Base64 para PDF — perguntas frequentes