El fitxer no s'obre: Get Info, Repara i deixeu d'endevinar
Quan un PDF no s'obre, executeu Get Info com a comprovació prèvia i després Repara per reconstruir l'estructura. És recuperació d'xref, no un clon d'escriptori.

Un PDF que no s'obre sol ser un problema d'estructura (taula de referències creuades trencada, descàrrega truncada, objectes malformats), no una imatge de pàgina que falti i que pugueu redibuixar a mà. Endevinar amb OCR, compressió o conversió malgasta temps fins que el fitxer es pot analitzar.
Primer Get Info
Get Info (POST /api/v1/security/get-info-on-pdf) retorna un informe JSON: FileSize, PageCount, Encrypted, els camps del diccionari Info quan hi són (title, author, subject, creator, producer), la Version del PDF, una llista simple Pages i si s'ha trobat una arrel de document. Feu-lo servir com a comprovació prèvia:
- Encrypted: true vol dir que necessiteu un Desbloqueja autoritzat abans de la majoria d'edicions; reparar tot sol no trenca contrasenyes.
- PageCount / FileSize semblen raonables però el vostre visor d'escriptori encara falla: proveu a continuació una Reparació estructural.
- La mateixa crida no aconsegueix carregar els bytes: potser el fitxer està massa danyat per a una passada d'Info neta; intenteu igualment Repara sobre una còpia.
Get Info no reescriu el PDF. Us diu què veu l'analitzador perquè deixeu de tractar cada fallada com si «calgués OCR» o «calgués comprimir».
Després Repara (reconstrucció estructural amb qpdf)
Repara PDF (POST /api/v1/misc/repair) reescriu el fitxer amb qpdf perquè els visors el puguin tornar a obrir quan queden prou objectes. Quan funciona, es conserva el contingut de pàgina previst; la tasca és el mapa del fitxer (xref o object streams), no una recuperació forense d'esborranys esborrats.
Repara no és:
- OCR o neteja d'escanejos (el fitxer s'obre però el text només és una imatge): feu servir OCR, que aquí retorna text Markdown, no una capa de PDF cercable
- Eliminació de contrasenya: feu servir Desbloqueja
- Reparació de fonts o «tornar a fer editable el fitxer»
- Un clon del producte de Windows «Recovery Toolbox for PDF»
Per a la distinció de marca i canal (reparació estructural en línia davant de les cerques d'escriptori de «recovery toolbox»), llegiu Reparar PDF en línia vs cerques de Recovery Toolbox.
Arbre de decisions per deixar d'endevinar
- El visor no pot obrir el fitxer: Get Info i després Repara.
- El fitxer s'obre però la selecció o la cerca fallen en un escaneig: OCR per obtenir text Markdown; opcionalment Comprimeix una còpia si la mida és el problema que queda (Paquet d'escanejos: OCR i després compressió).
- El fitxer s'obre i les taules s'exporten amb 204: no s'han detectat columnes; vegeu Exportació de taula buida (204).
- La mateixa reparació des d'un script o un agent:
POST /api/v1/misc/repairamb Desenvolupadors. Envieu unaIdempotency-Keysi el vostre client reintenta les càrregues (Idempotency-Key).
Què no arregla un fitxer «reparat»
Que una reparació tingui èxit vol dir que un visor pot tornar a obrir el fitxer. No vol dir que:
- Cada imatge de pàgina s'hagi reconstruït del no-res (els objectes que falten continuen faltant)
- El text s'hagi tornat seleccionable en un escaneig (aquí això és OCR → Markdown)
- El xifratge hagi desaparegut (cal Desbloqueja amb una contrasenya coneguda)
- Les taules s'exportaran (encara cal text columnar; 204 vol dir que no n'hi ha)
Si Get Info mostra un recompte de pàgines raonable després de Repara però una pàgina és en blanc, l'estructura s'ha recuperat i el contingut d'aquella pàgina pot continuar sent buit o truncat als bytes originals.
Conserveu l'original danyat
Conserveu l'original danyat al costat de qualsevol derivat reparat. Si Repara no pot recuperar prou estructura, el resultat honest és «els bytes s'han perdut», no una altra eina a l'atzar del catàleg. Comprimir o convertir un fitxer que encara no es pot analitzar no inventa els objectes que falten.
Compareu la intenció del canal (reparació estructural en línia davant de les cerques de marca d'escriptori «recovery toolbox») a Reparar PDF en línia vs cerques de Recovery Toolbox si així és com heu trobat l'eina. Les eines del catàleg no necessiten compte per al camí del navegador.