IRONSOFTWAREHOME

Problema de cuelgue, bloqueo o PDF en blanco en Linux con un depurador adjunto

Curtis Chau
Curtis Chau
Updated: 3 de julio de 2026

En Linux, adjuntar un depurador a tu aplicación puede dejar IronPDF colgado, devolver un PDF en blanco o bloquearse sin aviso. Ocurre siempre que un depurador está adjunto, sin importar la distribución de Linux o la versión de .NET.

IronPDF se representa a través de CEF (Chromium Embedded Framework), que por defecto genera subprocesos separados y aislados para manejar el renderizado. En Linux, esos subprocesos están bloqueados y no pueden ser rastreados con ptrace, y un proceso puede tener solo un rastreador a la vez. Adjuntar un depurador choca con la forma en que Chromium lanza sus subprocesos aislados, por lo que los subprocesos de renderizado se cuelgan. Tu aplicación ve eso como un bloqueo, un PDF en blanco o un fallo silencioso.

Solución

Recomendado: habilita el modo de proceso único. Configúralo durante el inicio de la aplicación, antes de tu primera operación con IronPDF:

IronPdf.Installation.SingleProcess = true;

El modo de proceso único mantiene el renderizado en el proceso principal, por lo que no hay un subproceso aislado con el que el depurador pueda chocar.

Debido a que esa configuración deshabilita el aislamiento de procesos de CEF y es menos estable bajo carga, mantenla fuera de producción. Delimítala a compilaciones de depuración para que nunca se envíe en una publicación:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
C#

[

Advertencia: El modo de proceso único deshabilita el aislamiento de procesos de CEF y es menos estable bajo carga. Elimínalo o exclúyelo de las compilaciones de lanzamiento antes de desplegar.
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,253,952Versión:2026.10recié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.10

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

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.

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 IronPDF
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
Tus detalles siempre serán mantenidos confidenciales.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Confiado por millones de ingenieros en todo el mundo
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.10

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

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