Resolvendo erros de dependência do PDFium

Atualizado:abril 23, 2026

Translated

View the article in English

O Google PDFIUM é um componente essencial do código principal do IronPDF, utilizado para diversas funções relacionadas à edição de PDFs e à conversão de documentos PDF em imagens. Se o binário PDFIUM estiver faltando na pasta do projeto, o seguinte erro será exibido durante a execução.

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying Pdfium for IronPdf: 'Unable to locate 'IronPdfInterop'

A instalação do pacote IronPDF no projeto geralmente resolve o problema.

No Windows, também é uma boa ideia garantir que o sistema operacional de destino tenha o Visual C++ Runtime instalado.

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 de 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 aumenta em mais do que o dobro a probabilidade de isolarmos 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).

// Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = true;

// Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

// Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = true;

// Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

' Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = True

' Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log"

' Set the logging mode to log all events.
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 são implantadas:

default.log (Processo de implantação)
cef.log (Renderização)
IronSoftwareCefSubprocess.log (Renderização & Threading)
IronSoftwareEngine.log (Útil para depuração de exceções começando com "Erro ao gerar PDF 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 ...