IronPDF 中 PDF 解析錯誤的疑難排解

This article was translated from English: Does it need improvement?
Translated
View the article in English

當您嘗試使用 IronPDF 解析 PDF 文件時,可能會遇到以下例外情況:

Unhandled exception. System.IO.IOException: PDF can not be opened as a PDF. May be an incorrect file type or a password is required.
Please check file for corruption or validity by a 3rd party at: https://www.pdf-online.com/osa/validate.aspx

此錯誤通常發生在使用以下程式碼將 PDF 文件載入 PdfDocument 物件時:

// Attempt to load a PDF document from a file
var pdf = PdfDocument.FromFile("Test.pdf");
// Attempt to load a PDF document from a file
var pdf = PdfDocument.FromFile("Test.pdf");
' Attempt to load a PDF document from a file
Dim pdf = PdfDocument.FromFile("Test.pdf")
$vbLabelText   $csharpLabel

可能的原因

  1. 密碼保護的 PDF
  • 擁有者密碼:引發此例外情況的最常見原因,是 PDF 檔案受到擁有者密碼的保護。 當 PDF 設有擁有者密碼時,會限制某些操作,例如編輯或複製。 若要載入此類文件,您必須提供密碼。
  1. 損壞的 PDF
  • 該 PDF 檔案可能已損毀,或非有效的 PDF 格式。 若檔案損毀,可能會導致 IronPDF 在解析過程中發生錯誤。

解決方案

  1. 處理受密碼保護的 PDF 檔案

若您知道 PDF 的密碼,可將其傳遞給 PdfDocument.FromFile() 方法:

// Load a password-protected PDF by specifying the owner password
var pdf = PdfDocument.FromFile("test.pdf", "ownerpassword");
// Load a password-protected PDF by specifying the owner password
var pdf = PdfDocument.FromFile("test.pdf", "ownerpassword");
' Load a password-protected PDF by specifying the owner password
Dim pdf = PdfDocument.FromFile("test.pdf", "ownerpassword")
$vbLabelText   $csharpLabel

您亦可透過 Adobe Acrobat 檢查檔案屬性,以確認該檔案是否設有密碼保護。 如需進一步了解如何識別 PDF 的安全性狀態,請參閱這篇文章

  1. 處理損壞的 PDF 檔案

若要檢查 PDF 檔案是否損壞,請使用第三方驗證工具。 若檔案已損毀,IronPDF 將無法解析該檔案。

若這些疑難排解步驟無法解決問題,請提交工程支援請求,以獲得我們支援工程師的進一步協助。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
Nuget 下載 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。