How-to3 min de lectura

Exportació de taula buida (204): el teu PDF probablement no té columnes

PDF a Excel i PDF a CSV retornen HTTP 204 quan no es detecten blocs de taula: és intencionat, no una fallada. Feu OCR dels escanejos; els PDF de prosa queden buits.

By the PDF123 team · Updated 2026-10-02
Exportació de taula buida (204): el teu PDF probablement no té columnes

Si PDF a Excel o PDF a CSV acaba amb HTTP 204 No Content i sense cos de descàrrega, l'extractor ha trobat zero blocs de taula. Aquest estat és deliberat: l'API es nega a inventar un full de càlcul buit quan l'heurística de composició no veu columnes.

Què busca l'extractor

Totes dues eines comparteixen la mateixa canalització. El servidor executa pdftotext -layout, divideix les pàgines pels límits de salt de formulari i agrupa les línies que semblen blocs columnars. Una línia compta com a tabular quan conté com a mínim dos espais consecutius (els canals de columna del mode layout). Un bloc només es conserva quan té com a mínim dues línies d'aquest tipus; una línia aïllada amb espais es descarta perquè els títols no es converteixin en «taules» d'una sola fila.

PDF a CSV (POST /api/v1/convert/pdf/csv) emet un CSV per cada taula detectada (anomenat amb la pàgina i l'índex de taula), o un ZIP quan n'hi ha diverses. PDF a Excel (POST /api/v1/convert/pdf/xlsx) escriu un llibre de treball amb un full per cada taula detectada.

Quan aquella llista és buida, tots dos retornen Output::no_content() mapat a 204. Un 200 amb un .xlsx en blanc seria més fàcil de confondre amb un èxit; un 204 vol dir «no hi ha res a exportar».

Motius habituals de rebre un 204

  • PDF només de prosa: text narratiu sense una alineació clara de columnes. Feu servir PDF a text o PDF a Markdown.
  • Pàgines escanejades sense capa de text: la sortida de pdftotext és buida, de manera que no apareix cap taula. Executeu OCR primer (text Markdown en aquest lloc) i reintenteu-ho només si les paraules formen columnes de debò.
  • Taules dibuixades només amb línies o imatges: les graelles visuals sense text de cel·la extractible no es converteixen en fulls.
  • Composicions de revista de diverses columnes i desordenades: l'heurística pot passar per alt blocs que una persona anomenaria «taula» o pot barrejar malament l'ordre de lectura.
  • «Taules» d'una sola fila: una línia amb espais no es converteix mai en bloc; calen com a mínim dues línies tabulars.

Els fitxers xifrats necessiten un Desbloqueja autoritzat abans de l'extracció. Repareu un fitxer danyat amb Reparar si Get Info o l'exportació no el poden obrir.

Què no és un 204

Un 204 no és una fallada de transport, ni un temps d'espera, ni «el servidor s'ha oblidat de l'adjunt». Tracteu-lo com una decisió correcta: no hi ha blocs de taula. Tornar a intentar el mateix fitxer sense canviar la capa de text ni la composició tornarà a donar 204. Els scripts haurien de bifurcar-se pel codi d'estat, no per un nom de fitxer buit.

El Markdown de l'OCR és una extracció de text per a agents, no un full de càlcul. Si enganxeu la sortida de l'OCR en un fitxer .md i després necessiteu columnes, encara us cal una composició que pdftotext -layout (o una persona) pugui veure com a canals; tornar a exportar el mateix PDF escanejat sense capa de text continuarà donant 204.

Què cal fer a continuació

  1. Obriu el PDF i confirmeu que podeu seleccionar el text de les cel·les. Si no, feu OCR i després decidiu si el text recuperat té prou columnes per a aquesta heurística.
  2. Preferiu PDF a Excel quan espereu diverses taules (un full per cadascuna). Preferiu PDF a CSV per a un sol fitxer pla o un ZIP de CSV.
  3. Si la pàgina és narrativa, canvieu d'eina; l'exportació de taules continuarà donant 204.
  4. Per a la gestió d'estats d'agents o canalitzacions, mapeu 204 → «no s'han detectat taules», no un bucle genèric de reintents.
  5. Si només necessiteu les paraules, atureu-vos a PDF a text o PDF a Markdown; forçar una forma de full de càlcul sobre prosa continuarà donant 204.

No cal compte per al camí del navegador. Els mateixos punts de destinació per HTTP: Desenvolupadors. Envieu una Idempotency-Key en els reintents si el vostre client pot fer POST dues vegades (Idempotency-Key).

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