Rozwiązywanie problemów z zależnościami Chrome w IronPDF

Zaktualizowano:25 stycznia, 2026

Translated

View the article in English

Google Chromium HTML renderer jest niezbędnym elementem procesu renderowania "Html To PDF" w IronPDF. Niezbędny plik binarny dla tego renderera powinien być łatwo dostępny wewnątrz pakietu IronPDF NuGet. Brak tego pliku binarnego w folderze projektu spowoduje wystąpienie następującego błędu:

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

Jeśli IronPDF nie jest w stanie automatycznie wdrożyć zależności Chrome, mogą one być wymagały ręcznego dodania do projektu poprzez NuGet. Można dodać wiele zależności:

Zwróć uwagęW późniejszych wersjach IronPDF wymagane pliki binarne będą automatycznie pobierane z źródła NuGet w oparciu o używany w czasie pracy system operacyjny, jeśli są nieobecne w folderze projektu. To będzie działać pod warunkiem, że projekt jest podłączony do Internetu i ma uprawnienia do odczytu, zapisu i wykonania w folderze projektu.

Na systemie Windows dobrze jest upewnić się, że docelowy system operacyjny ma zainstalowane Visual C++ Runtimes. Wiele nowoczesnych aplikacji nie może działać bez tego niezbędnego komponentu systemu operacyjnego.

Posiadamy także przewodniki dotyczące zgodności dla Linux i Docker.

Linux

Upewnij się, że używasz właściwego pliku Docker.
Użyj pakietu IronPdf.Linux NuGet zamiast IronPdf.

Ustaw tryb GPU dla renderowania Chrome jako wyłączony:

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

Wyłącz automatyczną konfigurację dla zależności Linux i Docker:

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

Sprawdź, czy środowisko uruchomieniowe .NET jest ustawione na odpowiednią architekturę - x64 lub arm64.

Co zrobić, jeśli to nie rozwiązuje problemu?

Jeśli to nie rozwiązuje problemu, jesteśmy tutaj, aby pomóc. Zgodność jest najwyższym priorytetem dla naszego zespołu inżynierów. Proszę wysłać zgłoszenie błędu e-mailem na support@ironsoftware.com. Wszystkie problemy z kompatybilnością będą dokładnie analizowane przez starszego inżyniera.

Upewnij się, że poinformujesz nas o systemie operacyjnym/platformie, na którą wdrażasz, szczególnie jeśli jest to platforma chmurowa jak AWS czy Azure.

Jak włączyć natywne logowanie w IronPDF

Dołączenie plików dziennika do zgłoszenia błędu więcej niż podwaja szansę, że możemy wyizolować problem i rozwiązać go szybko.

Umieść to na początku swojego kodu przed uruchomieniem jakichkolwiek metod IronPDF (wszystkie wersje po 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

Pliki dziennika utworzone przez IronPDF znajdują się w katalogu /bin twojego projektu, gdzie wdrażane są twoje DLLs:

default.log (Proces wdrażania)
cef.log (Renderowanie)
IronSoftwareCefSubprocess.log (Renderowanie i wielowątkowość)
IronSoftwareEngine.log (Przydatne do debugowania wyjątków zaczynających się od 'Błąd generowania PDF z...')

Serwery chmurowe często mają określone lokalizacje dla plików dziennika. Mamy przewodniki dotyczące generowania plików dziennika w Azure i AWS.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released