IRONSOFTWAREHOME

Cómo solucionar problemas de tiempo de espera en la renderización de PDF

Curtis Chau
Curtis Chau
Updated: 10 de junio de 2025
  • No se puede renderizar PDF desde HTML
  • No se puede renderizar PDF desde URL
  • Error al generar PDF desde HTML
  • Error al generar PDF desde URL
  • Excepción nativa no especificada

Estos mensajes de error genéricos indican que el motor de renderizado de Chrome ha encontrado un fallo.

Aplicar el fragmento de código a continuación producirá un archivo de registro "Default.log" que puede ayudar a determinar la causa del fallo.

// 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";

Tiempo de espera de renderización

El tiempo de espera es una función implementada en IronPDF para evitar que las aplicaciones queden en deadlock y se vuelvan no responsivas debido a largas duraciones de renderizado de PDF. Esto puede ayudar a los usuarios a gestionar recursos, asegurando que recursos como CPU, memoria y ancho de banda de red no estén ocupados con procesos que tardan demasiado en completarse. Se lanzará un error de tiempo de espera, como se describe a continuación, si el proceso de renderizado de PDF no se completa a tiempo.

  • Tiempo de espera de 60s al renderizar PDF desde HTML
  • Tiempo de espera de 60s al renderizar PDF desde URL
  • Tiempo de espera al generar PDF desde HTML
  • Tiempo de espera al generar PDF desde URL
  • Tiempo de espera al renderizar PDF desde HTML
  • Tiempo de espera al renderizar PDF desde URL

Hay muchas razones para los tiempos de renderizado prolongados en IronPDF que podrían llevar a errores de tiempo de espera, como renderizar PDFs grandes o pesados, recuperar recursos/remotos para renderizar PDFs, o problemas durante el renderizado mismo. Sin embargo, anular la duración del tiempo de espera generalmente puede resolver el problema.

Para anular la configuración predeterminada, los usuarios pueden acceder a la propiedad Timeout en la clase ChromePdfRenderOptions y configurarla a un valor más alto.

// Set the timeout for rendering to 120 seconds.
RenderingOptions.Timeout = 120; // seconds
Por favor nota: A partir de la versión 2021.12.4995, el tiempo de espera de renderizado predeterminado de IronPDF es de 60 segundos.

Retraso de renderización

En algunas ocasiones, IronPDF puede renderizar:

  • Un PDF en blanco
  • Un PDF con contenido incompleto
  • Un PDF con activos de imagen faltantes

Este problema puede ocurrir porque el documento PDF fue renderizado antes de que la llamada para recuperar los contenidos o activos del recurso se completara a tiempo.

Aplicar un retraso de renderizado al renderizador de PDF generalmente ayuda a resolver el problema. Esto indicará al renderizador que retrase el renderizado de PDF por una duración establecida, para que los contenidos o activos puedan cargarse a tiempo antes de renderizar el PDF. Para hacer esto, simplemente acceda al método RenderDelay() en el objeto envoltorio WaitFor, establezca el tiempo de duración deseado como parámetro del método y aplíquelo al renderizador como una de las propiedades ChromePdfRenderOptions.

// Set a render delay of 5000 milliseconds (5 seconds) to ensure content and assets are loaded before rendering.
RenderingOptions.WaitFor.RenderDelay(5000);  // milliseconds
Por favor nota: La duración predeterminada de RenderDelay es 20 ms

Además del método RenderDelay(), también hay otros métodos en el objeto envoltorio WaitFor que se pueden utilizar.

Para más información sobre registros y cómo reportar un error a nuestros ingenieros para su revisión, por favor vea Cómo hacer una solicitud de soporte técnico para IronPDF.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...
Leer más

¿Listo para empezar?

Nuget Downloads 21,105,021Versión:2026.9recién publicada

Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999