Convertire Base64 in PDF e file · PDF in Base64

Base64 in PDF — risposte rapide

Che cos'è un PDF in 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

Funzionalità

Base64 in PDF con Python, Java, JavaScript e altri

Esempi di conversione da Base64 a PDF

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4K…

PDF · versione 1.4 · scaricato come file.pdf

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

Interpretato così: virgolette rimosse → escape JSON annullati → prefisso data URI rimosso (application/pdf)

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

Interpretato così: campo data.file estratto dal JSON

data:application/pdf;base64,iVBORw0KGgoAAAANSUhEUgAA…

Attenzione: il data URI dichiara application/pdf, ma i byte sono PNG. Salvato come file.png

255044462d312e370a…

Attenzione: sembra esadecimale; letto come hex è un PDF. [Decodifica come hex]

Come convertire Base64 in PDF

1. 1

   Incolla il Base64 così come l'hai ricevuto

   Base64 puro, data:application/pdf;base64,…, una stringa copiata da un JSON con escape \/ o l'intera risposta dell'API. Per stringhe molto lunghe usa Apri un file .txt invece di incollare.

2. 2

   Controlla come è stato interpretato

   La riga sotto la casella elenca ogni passaggio di pulizia: prefisso rimosso, escape annullati, padding aggiunto, campo estratto dal JSON. Se qualcosa non va, l'errore indica il carattere esatto e la sua posizione.

3. 3

   Guarda il tipo rilevato e gli avvisi

   Il badge mostra il tipo letto dai magic byte del file. Compare una nota gialla se in realtà non è un PDF, se il data URI dichiara un tipo falso o se il PDF è interrotto prima di %%EOF.

4. 4

   Visualizza l'anteprima e scarica

   I PDF si aprono nel visualizzatore del browser, immagini e testo vengono mostrati nella pagina. Rinomina il file se vuoi e clicca Scarica. Per la direzione opposta, passa a PDF / file → Base64 e trascina un file.

Perché un PDF Base64 non si apre: errori comuni

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 serve convertire Base64 in PDF

Un'API restituisce il PDF in Base64

Le API di fatturazione, firma elettronica e stampa di etichette spesso restituiscono i documenti dentro un JSON. Incolla la risposta per controllare il documento prima di scrivere il codice che lo salva.

Fare debug di un PDF che non si apre

Quando il file salvato è vuoto o danneggiato, incolla qui lo stesso Base64. Lo strumento ti dice se è troncato, codificato due volte, se non è affatto un PDF oppure se è a posto: in quel caso il bug sta nel modo in cui il tuo codice scrive il file.

Inviare un file in una richiesta JSON

Molti endpoint di upload si aspettano {"filename": …, "content": "<base64>"}. Codifica qui il file per costruire una richiesta di prova in Postman o cURL.

Incorporare un file in HTML, CSS o email

Genera un data URI per un link a un PDF inline, un font o una piccola immagine, oppure Base64 a 76 colonne per una parte MIME di un'email.

Recuperare allegati da log e database

I file salvati in una colonna di testo o stampati in un log si possono estrarre direttamente, e un %%EOF mancante ti dice che la colonna o la riga di log era troppo corta.

Come funziona la codifica Base64 dei file

Perché il Base64 è più grande del 33%

Ogni carattere trasporta 6 bit, quindi 3 byte (24 bit) richiedono 4 caratteri. Con il padding la lunghezza è 4 × ⌈n ÷ 3⌉: 100 KB (102.400 byte) diventano 136.536 caratteri. Il formato MIME aggiunge un CRLF ogni 76 caratteri, quindi 1 MB diventa 1.434.896 caratteri invece di 1.398.104.

Alfabeto standard e alfabeto URL-safe

L'RFC 4648 definisce due alfabeti che differiscono solo negli ultimi due caratteri: + / (standard, sezione 4) e - _ (sicuro per URL e nomi di file, sezione 5). Il Base64 URL-safe di solito omette il padding =. Se una stringa li mescola, è stata modificata o unita da due fonti.

Padding e lunghezze impossibili

Il padding = rende la lunghezza un multiplo di 4. Senza, un resto di 2 o 3 si può ripristinare; un resto di 1 è impossibile per qualsiasi Base64 valido: un carattere è andato perso o è stato aggiunto. Un = nel mezzo di solito significa che due stringhe sono state concatenate.

I magic byte decidono il tipo

Un file dichiara il suo formato nei primi byte: %PDF- per i PDF, 89 50 4E 47 per i PNG, 50 4B 03 04 per i formati basati su ZIP come DOCX e XLSX. Quei byte fissano i primi caratteri del Base64, quindi il tipo si può leggere prima di decodificare: vedi la tabella nello strumento.

Come si rileva un PDF troncato

Un PDF termina con %%EOF. Se non compare negli ultimi 1.024 byte, il file è quasi certamente stato troncato. L'intestazione può iniziare fino a 1.024 byte più avanti; la maggior parte dei lettori apre comunque questi file, quindi viene segnalato ma non rifiutato.

Buone pratiche per inviare file in Base64

Invia il tipo MIME e il nome del file insieme ai dati

Il Base64 non contiene né nome né tipo. Mettili accanto ({"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}) oppure usa un data URI, così chi riceve non deve indovinare.

Controlla i magic byte lato ricezione

Prima di salvare, verifica che i byte decodificati inizino con %PDF-. Con una riga di codice intercetti campi sbagliati, doppia codifica e pagine di errore restituite in Base64.

Per i file grandi preferisci multipart o un URL

Il Base64 aggiunge un terzo alla dimensione e l'intera stringa deve stare in memoria. Oltre qualche megabyte, multipart/form-data o un URL di download prefirmato pesa meno su entrambi i lati.

Nel database salva i byte, non il Base64

Una colonna BLOB/bytea occupa un terzo in meno e non può essere troncata in silenzio come un VARCHAR. Codifica in Base64 solo al confine dell'API.

Base64 in PDF — domande frequenti