Fixing PDF Rendering Timeout Issues

This article was translated from English: Does it need improvement?
Translated
View the article in English
  • Unfähig, PDF aus HTML zu rendern
  • Unfähig, PDF aus URL zu rendern
  • Fehler beim Generieren von PDF aus HTML
  • Fehler beim Generieren von PDF aus URL
  • Nicht spezifizierte native Ausnahme

Diese generischen Fehlermeldungen weisen darauf hin, dass die Chrome-Rendering-Engine auf einen Fehler gestoßen ist.

Das Anwenden des untenstehenden Codeausschnitts wird eine "Default.log"-Protokolldatei erzeugen, die dabei helfen kann, die Ursache des Fehlers zu bestimmen.

// Enable logging for all events and set the file path for the log file.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable logging for all events and set the file path for the log file.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
IronPdf.Logging.Logger.LogFilePath = "Default.log";
' Enable logging for all events and set the file path for the log file.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All
IronPdf.Logging.Logger.LogFilePath = "Default.log"
$vbLabelText   $csharpLabel

Render-Timeout

Timeout ist eine in IronPDF implementierte Funktion, um zu verhindern, dass Anwendungen in einem Deadlock hängen bleiben und nicht mehr reagieren, aufgrund von langen PDF-Rendering-Dauern. Dies kann Benutzern helfen, Ressourcen zu verwalten, und sicherstellen, dass Ressourcen wie CPU, Speicher und Netzwerkbandbreite nicht mit Prozessen blockiert werden, die zu lange brauchen, um abgeschlossen zu werden. Ein Timeout-Fehler, wie unten beschrieben, wird ausgelöst, wenn der PDF-Rendering-Prozess nicht rechtzeitig abgeschlossen wird.

  • Timeout nach 60s beim Rendern von PDF aus HTML
  • Timeout nach 60s beim Rendern von PDF aus URL
  • Timeout beim Generieren von PDF aus HTML
  • Timeout beim Generieren von PDF aus URL
  • Timeout beim Rendern von PDF aus HTML
  • Timeout beim Rendern von PDF aus URL

Es gibt viele Gründe für lange Rendering-Zeiten in IronPDF, die zu Timeout-Fehlern führen könnten, wie z.B. das Rendern großer oder aufwendiger PDFs, das Abrufen von entfernten Ressourcen/Assets zum Rendern von PDFs oder Probleme beim Rendering selbst. Das Überschreiben der Timeout-Dauer kann jedoch normalerweise das Problem beheben.

Um die Standardeinstellung zu überschreiben, können Benutzer auf die Timeout-Eigenschaft in der ChromePdfRenderOptions-Klasse zugreifen und sie auf einen höheren Wert einstellen.

// Set the timeout for rendering to 120 seconds.
RenderingOptions.Timeout = 120; // seconds
// Set the timeout for rendering to 120 seconds.
RenderingOptions.Timeout = 120; // seconds
' Set the timeout for rendering to 120 seconds.
RenderingOptions.Timeout = 120 ' seconds
$vbLabelText   $csharpLabel

Hinweis:Ab Version 2021.12.4995 beträgt die Standard-Render-Zeitüberschreitung von IronPDF 60 Sekunden.

Render-Verzögerung

In einigen Fällen kann IronPDF folgende rendern:

  • Ein leeres PDF
  • Ein PDF mit unvollständigem Inhalt
  • Ein PDF mit fehlenden Bild-Assets

Dieses Problem könnte auftreten, weil das PDF-Dokument gerendert wurde, bevor der Aufruf zum Abrufen der Inhalte oder Assets aus der Ressource rechtzeitig abgeschlossen war.

Das Anwenden einer Render-Verzögerung auf den PDF-Renderer hilft normalerweise, das Problem zu beheben. Dies wird den Renderer anweisen, das PDF-Rendering für eine festgelegte Dauer zu verzögern, damit die Inhalte oder Assets rechtzeitig geladen werden können, bevor das PDF-Rendering beginnt. Dazu greifen Sie einfach auf die RenderDelay()-Methode im WaitFor-Wrapper-Objekt zu, stellen die gewünschte Dauer als Methodenparameter ein und wenden diese auf den Renderer als eine der ChromePdfRenderOptions-Eigenschaften an.

// Set a render delay of 5000 milliseconds (5 seconds) to ensure content and assets are loaded before rendering.
RenderingOptions.WaitFor.RenderDelay(5000);  // milliseconds
// Set a render delay of 5000 milliseconds (5 seconds) to ensure content and assets are loaded before rendering.
RenderingOptions.WaitFor.RenderDelay(5000);  // milliseconds
' Set a render delay of 5000 milliseconds (5 seconds) to ensure content and assets are loaded before rendering.
RenderingOptions.WaitFor.RenderDelay(5000) ' milliseconds
$vbLabelText   $csharpLabel

Hinweis:Die Standard-RenderDelay-Dauer beträgt 20 ms

Neben der RenderDelay()-Methode gibt es auch andere Methoden im WaitFor-Wrapper-Objekt, die verwendet werden können.

Für weitere Informationen zu Protokollen und wie Sie einen Fehler unseren Ingenieuren zur Überprüfung melden können, siehe bitte Wie man eine technische Support-Anfrage für IronPDF stellt.

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 ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht