IRONSOFTWAREHOME

Fehlersuche bei Chrome-Abhängigkeiten in IronPDF

Curtis Chau
Curtis Chau
Updated: 22. April 2026

Der Google Chromium HTML-Renderer ist ein wesentlicher Bestandteil des "Html zu PDF"-Rendering-Prozesses von IronPDF. Die wesentliche Binärdatei für diesen Renderer sollte sich leicht im IronPDF NuGet-Paket finden lassen. Fehlt diese Binärdatei im Projektordner, wird folgender Fehler angezeigt:

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

Wenn IronPDF die Chrome-Abhängigkeiten nicht automatisch bereitstellen kann, müssen sie möglicherweise manuell über NuGet zu einem Projekt hinzugefügt werden. Mehrere Abhängigkeiten können hinzugefügt werden:

Hinweis:: In späteren Versionen von IronPDF werden die erforderlichen Binärdateien bei Abwesenheit im Projektordner automatisch von der NuGet-Quelle basierend auf dem zur Laufzeit verwendeten Betriebssystem heruntergeladen. Dies wird erfolgreich sein, solange das Projekt mit dem Internet verbunden ist und Lese-, Schreib- und Ausführungsberechtigungen für den Projektordner hat.

Unter Windows ist es eine gute Idee, sicherzustellen, dass das Zielbetriebssystem über Visual C++ Runtimes verfügt. Viele moderne Anwendungen können ohne diese wesentliche Betriebssystemkomponente nicht ausgeführt werden.

Wir haben auch Kompatibilitätsleitfäden für Linux und Docker.

Linux

  • Die richtige Docker-Datei verwenden.

  • Nutzen Sie das IronPdf.Linux NuGet-Paket anstelle von IronPDF.

  • Stellen Sie den GPU-Modus für das Chrome-Rendering auf deaktiviert:

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
  • Deaktivieren Sie die automatische Konfiguration für Linux- und Docker-Abhängigkeiten:

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;

MacOS

  • Überprüfen Sie, ob die .NET-Laufzeit auf die richtige Architektur eingestellt ist - x64 oder arm64.

Was zu tun ist, wenn das nicht hilft?

Wenn das das Problem nicht löst, sind wir hier, um zu helfen. Kompatibilität hat für unser Ingenieurteam hohe Priorität. Bitte senden Sie einen Fehlerbericht per E-Mail an support@ironsoftware.com. Alle Kompatibilitätsprobleme werden von einem leitenden Ingenieur ernsthaft geprüft.

Informieren Sie uns unbedingt über das Einsatzbetriebssystem/-plattform, insbesondere wenn es sich um eine Cloud-Plattform wie AWS oder Azure handelt.

So aktivieren Sie die native Protokollierung in IronPDF

Das Anhängen von Protokolldateien an einen Fehlerbericht verdoppelt mehr als die Wahrscheinlichkeit, dass wir das Problem isolieren und schnell lösen können.

Platzieren Sie dies oben in Ihrem Code, bevor Sie IronPDF-Methoden ausführen (alle Versionen nach 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;

Logdateien, die von IronPDF erstellt werden, befinden sich im /bin-Verzeichnis Ihres Projekts, wo Ihre DLLs bereitgestellt werden:

  • default.log (Bereitstellungsprozess)
  • cef.log (Rendering)
  • IronSoftwareCefSubprocess.log (Rendering & Threading)
  • IronSoftwareEngine.log (Nützlich zum Debuggen von Ausnahmen, die mit "Fehler beim Generieren von PDF aus..." beginnen)

Cloud-Server haben oft spezifische Speicherorte für Protokolldateien. Wir haben Anleitungen zur Generierung von Log-Dateien in Azure und AWS.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...
Weiterlesen

Bereit anzufangen?

Nuget Downloads 21,105,021Version:2026.9gerade veröffentlicht

Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

OR
bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Kundenlogos von Iron Software
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $