How-to3 min di lettura

Esportazione tabella vuota (204): probabilmente il PDF non ha colonne

PDF in Excel e PDF in CSV restituiscono HTTP 204 senza blocchi tabellari rilevati: è voluto, non un crash. Prima l'OCR delle scansioni; la sola prosa resta vuota.

By the PDF123 team · Updated 2026-10-02
Esportazione tabella vuota (204): probabilmente il PDF non ha colonne

Se PDF in Excel o PDF in CSV termina con HTTP 204 No Content e senza corpo da scaricare, l'estrattore ha trovato zero blocchi tabellari. Quello status è intenzionale: l'API rifiuta di inventare un foglio di calcolo vuoto quando l'euristica di impaginazione non vede colonne.

Cosa cerca l'estrattore

Entrambi gli strumenti condividono la stessa pipeline. Il server esegue pdftotext -layout, divide le pagine sui caratteri di avanzamento modulo e raggruppa le righe che sembrano blocchi a colonne. Una riga è considerata tabellare quando contiene almeno due spazi consecutivi (le gutter di colonna della modalità layout). Un blocco viene mantenuto solo se ha almeno due righe di questo tipo; una singola riga spaziata viene scartata, così i titoli non diventano «tabelle» di una riga.

PDF in CSV (POST /api/v1/convert/pdf/csv) produce un CSV per ogni tabella rilevata (con nome che include pagina e indice della tabella), oppure uno ZIP quando ce ne sono diverse. PDF in Excel (POST /api/v1/convert/pdf/xlsx) scrive una cartella di lavoro con un foglio per ogni tabella rilevata.

Quando quell'elenco è vuoto, entrambi restituiscono Output::no_content() mappato a 204. Un 200 con un .xlsx vuoto sarebbe più facile da interpretare erroneamente come successo; 204 significa «niente da esportare».

Motivi comuni per cui ottieni 204

  • PDF di sola prosa: testo narrativo senza un chiaro allineamento a colonne. Usa invece PDF in testo o PDF in Markdown.
  • Pagine scansionate senza strato di testo: l'output di pdftotext è vuoto, quindi non compaiono tabelle. Applica prima l'OCR (testo Markdown su questo sito), poi riprova solo se le parole formano davvero colonne.
  • Tabelle disegnate solo con linee o immagini: griglie visive senza testo di cella estraibile non diventano fogli.
  • Impaginazioni disordinate a più colonne, da rivista: l'euristica può mancare blocchi che una persona chiamerebbe «tabella», oppure fondere male l'ordine di lettura.
  • «Tabelle» di una sola riga: una riga spaziata non diventa mai un blocco; servono almeno due righe tabellari.

I file cifrati richiedono uno Sblocco autorizzato prima dell'estrazione. Ripara un file danneggiato con Ripara se Get Info o l'esportazione non riescono ad aprirlo.

Cosa non è il 204

Il 204 non è un errore di trasporto, non è un timeout e non significa «il server ha dimenticato l'allegato». Consideralo una decisione andata a buon fine: nessun blocco tabellare. Ripetere lo stesso identico file senza cambiare lo strato di testo o l'impaginazione restituirà di nuovo 204. Gli script dovrebbero diramare sul codice di stato, non su un nome di file vuoto.

Il Markdown dell'OCR da OCR è un'estrazione di testo per gli agenti, non un foglio di calcolo. Se incolli l'output OCR in un file .md e in seguito ti servono le colonne, ti serve comunque un'impaginazione che pdftotext -layout (o una persona) possa vedere come gutter: riesportare lo stesso PDF scansionato senza strato di testo continuerà a restituire 204.

Cosa fare dopo

  1. Apri il PDF e verifica di poter selezionare il testo delle celle. Se non puoi, applica l'OCR, poi decidi se il testo recuperato è abbastanza colonnare per questa euristica.
  2. Preferisci PDF in Excel quando ti aspetti più tabelle (un foglio ciascuna). Preferisci PDF in CSV per un singolo file piatto o uno ZIP di CSV.
  3. Se la pagina è narrativa, cambia strumento: l'esportazione di tabelle continuerà a restituire 204.
  4. Per la gestione dello stato in agenti o pipeline, mappa il 204 su «nessuna tabella rilevata», non su un ciclo generico di nuovi tentativi.
  5. Se ti servono solo le parole, fermati a PDF in testo o PDF in Markdown; forzare una forma a foglio di calcolo su un testo narrativo continuerà a restituire 204.

Per il percorso nel browser non è richiesto alcun account. Gli stessi endpoint via HTTP: Developers. Invia un Idempotency-Key sui nuovi tentativi se il tuo client può inviare la POST due volte (Idempotency-Key).

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