Troubleshooting Chrome Dependencies in IronPDF

更新日期:8月 20, 2025

Translated

View the article in English

Google Chromium HTML 渲染器是 IronPDF 的 “Html To PDF” 渲染過程中的重要組成部分。這個渲染器的必要二進位檔案應該容易地在 IronPDF 的 NuGet 套件中找到。專案資料夾中如果缺少這個二進位檔，會出現以下錯誤：

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.

如果 IronPDF 無法自動部署 Chrome 相依性，可能需要透過 NuGet 手動添加到專案中。可以添加多個相依性：

請注意在 IronPDF 的後續版本中，若專案資料夾中缺少必要的二進位檔，系統會根據運行時使用的作業系統自動從 NuGet 來源下載。只要專案連接到網路並對專案資料夾具有讀取、寫入和執行的權限，這將會成功。

在 Windows 上，確保目標作業系統已安裝 Visual C++ 運行時是一個好主意。很多現代應用程式在沒有這個基本作業系統元件的情況下無法運行。

We also have compatibility guides for Linux and Docker.

Linux

確保使用了正確的Docker檔案。
使用 IronPdf.Linux NuGet 套件，而不是 IronPdf。

設定 Chrome 渲染的 GPU 模式為禁用：

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

禁用 Linux 和 Docker 相依性的自動配置：

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

檢查 .NET 運行時是否設置為正確的架構 - x64 或 arm64。

如果這無法解決問題該怎麼辦？

如果這無法解決問題，我們會在這裡幫助。相容性是我們工程團隊的高優先事項。請發送電子郵件錯誤報告至 support@ironsoftware.com。所有相容性問題將由高級工程師嚴肅審查。

務必告知我們部署的作業系統/平台，特別是如果它是像 AWS 或 Azure 的雲平台。

如何在IronPDF中啟用原生記錄功能

附加記錄檔案到錯誤報告可以 超過加倍地提高我們隔離問題並迅速解決它的概率。

在運行任何 IronPDF 方法之前，將此放置於程式碼頂部（所有版本在2021.3.1之後）：

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

' Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log"
' Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All

$vbLabelText $csharpLabel

IronPDF創建的記錄文件位於專案的 /bin 目錄中，DLL 部署於此處：