Solución de problemas de dependencias de Chrome en IronPDF

Actualizado:agosto 20, 2025

Translated

View the article in English

El renderizador HTML de Google Chromium es una parte esencial del proceso de renderizado de "Html To PDF" de IronPDF. El binario esencial para este renderizador debería encontrarse fácilmente dentro del paquete NuGet de IronPDF. La ausencia de este binario en la carpeta del proyecto generará el siguiente error:

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

Si IronPDF no puede implementar automáticamente las dependencias de Chrome, es posible que deban agregarse al proyecto manualmente a través de NuGet. Se pueden agregar múltiples dependencias:

Por favor notaEn versiones posteriores de IronPDF, los binarios necesarios se descargarán automáticamente de la fuente NuGet basada en el sistema operativo utilizado durante el tiempo de ejecución, si están ausentes de la carpeta del proyecto. La traducción se realizará correctamente siempre que el proyecto esté conectado a Internet y tenga permisos de lectura, escritura y ejecución en la carpeta del proyecto.

En Windows, es una buena idea asegurarse de que el sistema operativo objetivo tenga instalados los Runtimes de Visual C++. Muchas aplicaciones modernas no pueden ejecutarse sin este componente esencial del sistema operativo.

También tenemos guías de compatibilidad para Linux y Docker.

Linux

Asegúrese de que se utilice el archivo Docker correcto.
Use el paquete NuGet IronPdf.Linux en lugar de IronPdf.

Configure el modo GPU de Chrome como deshabilitado.

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

Desactive la configuración automática de las dependencias de Linux y Docker:

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

Verifique que el tiempo de ejecución de .NET esté configurado en la arquitectura correcta - x64 o arm64.

¿Qué hacer si no se soluciona?

Si eso no soluciona el problema, estamos aquí para ayudarle. La compatibilidad es una alta prioridad para nuestro equipo de ingeniería. Por favor, envíe un informe de error por correo electrónico a support@ironsoftware.com. Todos los problemas de compatibilidad serán revisados seriamente por un ingeniero senior.

Asegúrese de informarnos sobre el sistema operativo/plataforma en la que se implementa, especialmente si es una plataforma en la nube como AWS o Azure.

Cómo activar el registro nativo en IronPDF

Adjuntar archivos de registro a un informe de error más que duplica la probabilidad de que podamos aislar el problema y resolverlo rápidamente.

Coloque esto en la parte superior de su código antes de ejecutar cualquier método de IronPDF (todas las versiones posteriores a 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

Los archivos de registro creados por IronPDF se encuentran en el directorio /bin de su proyecto donde se implementan sus DLLs:

default.log (Proceso de implementación)
cef.log (Renderizado)
IronSoftwareCefSubprocess.log (Renderizado y Subprocesos)
IronSoftwareEngine.log (Útil para depurar excepciones comenzando con 'Error generando PDF desde...')

Los servidores en la nube tienen ubicaciones específicas para registros. Tenemos guías para generar archivos de registro en Azure y AWS.

Curtis Chau

Chatea con el equipo de ingeniería ahora

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

¿Listo para empezar?

Nuget Descargas 16,685,821 | Versión: 2025.12 recién lanzado

Ver Licencias