Solução de problemas de dependências do Chrome no IronPDF

Atualizado:janeiro 25, 2026

Translated

View the article in English

O renderizador HTML do Google Chromium é uma parte essencial do processo de renderização "HTML para PDF" do IronPDF. O binário essencial para este renderizador pode ser facilmente encontrado dentro do pacote NuGet do IronPDF . A ausência deste binário na pasta do projeto resultará no seguinte erro:

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

Caso o IronPDF não consiga implantar as dependências do Chrome automaticamente, talvez seja necessário adicioná-las manualmente ao projeto por meio do NuGet. É possível adicionar múltiplas dependências:

ObserveEm versões posteriores do IronPDF, os binários necessários serão baixados automaticamente da fonte NuGet com base no sistema operacional usado durante a execução, caso estejam ausentes da pasta do projeto. Isso funcionará desde que o projeto esteja conectado à Internet e tenha permissões de Leitura, Gravação e Execução na pasta do projeto.

No Windows, é uma boa ideia garantir que o sistema operacional de destino tenha o Visual C++ Runtime instalado. Muitos aplicativos modernos não funcionam sem esse componente essencial do sistema operacional.

Também temos guias de compatibilidade para Linux e Docker .

Linux

Certifique-se de que o arquivo Docker correto esteja sendo usado.
Use o pacote NuGet IronPDF .Linux em vez do IronPDF.

Desative o modo GPU para renderização no Chrome:

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

Desative a configuração automática para dependências do Linux e do Docker:

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

Verifique se o ambiente de execução do .NET está configurado para a arquitetura correta: x64 ou arm64.

O que fazer se isso não resolver o problema?

Se isso não resolver o problema, estamos aqui para ajudar. A compatibilidade é uma prioridade para nossa equipe de engenharia. Por favor, envie um e-mail relatando o erro parasupport@ironsoftware.com . Todas as questões de compatibilidade serão analisadas cuidadosamente por um engenheiro sênior.

Não se esqueça de nos informar sobre o sistema operacional/plataforma em que será feita a implantação, especialmente se for uma plataforma em nuvem como AWS ou Azure.

Como habilitar o registro nativo no IronPDF

Anexar arquivos de log a um relatório de erros mais que dobra a probabilidade de conseguirmos isolar o problema e resolvê-lo rapidamente.

Coloque este trecho de código no início do seu arquivo, antes de executar qualquer método do IronPDF (todas as versões 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

Os arquivos de log criados pelo IronPDF são encontrados no diretório /bin do seu projeto, onde suas DLLs estão implantadas:

default.log (Processo de implantação)
cef.log (Renderização)
IronSoftwareCefSubprocess.log (Renderização e Threading)
IronSoftwareEngine.log (Útil para depurar exceções que começam com "Erro ao gerar PDF a partir de...")

Os servidores em nuvem geralmente possuem locais específicos para arquivos de log. Temos guias para gerar arquivos de log no Azure e na AWS .

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...