How-to約 1 分鐘閱讀

檔案打不開:先 Get Info、再 Repair,然後停止猜測

PDF 打不開時,先用 Get Info 做預檢,再用 Repair 重建結構。那是 xref 復原,不是桌面 Recovery Toolbox 的翻版。

By the PDF123 team · Updated 2026-10-04
檔案打不開:先 Get Info、再 Repair,然後停止猜測

打不開的 PDF 通常是結構問題(交叉參照表壞掉、下載被截斷、物件畸形),不是缺了一張你可以手畫出來的頁面影像。在檔案能被解析之前,用 OCR、壓縮或轉換去猜,都是浪費時間。

先跑 Get Info

取得資訊(POST /api/v1/security/get-info-on-pdf)回傳一份 JSON 報告:FileSize、PageCount、Encrypted,存在時的 Info 字典欄位(title、author、subject、creator、producer)、PDF Version、一份簡單的 Pages 清單,以及是否找到文件根。把它當成預檢使用:

  • Encrypted: true 表示多數編輯之前需要經過授權的 解鎖;單靠修復不會破解密碼。
  • PageCount/FileSize 看起來合理,但桌面檢視器仍然打不開:下一步試結構性的 修復。
  • 呼叫本身載入不了位元組:檔案可能損壞到連一次乾淨的 Info 都過不去,仍然可以對副本試一次修復。

Get Info 不會改寫 PDF。它告訴你解析器能看見什麼,好讓你別再遇到失敗就當成「需要 OCR」或「需要壓縮」。

再跑 Repair(經 qpdf 重建結構)

修復 PDF(POST /api/v1/misc/repair)用 qpdf 重寫檔案,只要殘餘的物件夠多,檢視器就能重新打開它。修好之後,原本要呈現的頁面內容會被保留;這項工作修的是檔案的地圖(xref/物件串流),不是把已刪草稿取證式地反刪除。

修復不是:

  • OCR 或掃描清理(檔案能開,文字只是影像):用 OCR,它在這裡預設回傳 Markdown 文字,選擇可搜尋的 PDF 輸出時則回傳帶有文字層的 PDF
  • 移除密碼:用 解鎖
  • 字型修復,或者「讓檔案重新可編輯」
  • Windows 產品「Recovery Toolbox for PDF」的翻版

品牌與通路的區別(線上結構修復 vs 桌面「recovery toolbox」搜尋),見 線上 PDF 修復與 Recovery Toolbox 搜尋。

不再瞎猜的決策樹

  1. 檢視器打不開檔案:先 取得資訊,再 修復。
  2. 檔案能開,但掃描頁上選不中、搜不到:OCR 取 Markdown 文字或可搜尋的 PDF;如果體積仍是問題,可選擇性對副本做 壓縮(掃描包:先 OCR 再壓縮)。
  3. 檔案能開,表格卻匯出成 204:沒有偵測到欄位,見 空白表格匯出(204)。
  4. 想從腳本或 Agent 做同樣的修復:經 開發者 呼叫 POST /api/v1/misc/repair。用戶端會重試上傳時,請帶上 Idempotency-Key(Idempotency-Key)。

「已修復」仍然修不好什麼

修復成功,只代表檢視器又能打開這份檔案。它不代表:

  • 每一頁影像都從虛無中被重建出來(缺失的物件仍然缺失)
  • 掃描頁上的文字變得可選取(那是 OCR,在這裡產出 Markdown 或可搜尋的 PDF)
  • 加密消失(要用已知密碼解鎖)
  • 表格能匯出了(仍然需要欄狀文字;204 代表一個都沒偵測到)

如果修復後 Get Info 顯示的頁數合理,某一頁卻是空白,那是結構恢復了,而該頁內容在原始位元組裡可能本來就是空的或被截斷。

保留損壞的原件

在任何修復衍生物的旁邊,請保留那份損壞的原件。如果修復無法恢復出足夠的結構,誠實的結論是「位元組已經沒了」,而不是在目錄裡再隨機換一個工具去試。壓縮或轉換一份仍然解析不了的檔案,不會憑空補出缺失的物件。

如果你是透過桌面「recovery toolbox」的品牌搜尋找到這個工具的,通路意圖的對比見 線上 PDF 修復與 Recovery Toolbox 搜尋。目錄工具的瀏覽器路徑不需要帳號。

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