Resolvendo erros de dependência do PDFium

Atualizado:junho 1, 2025

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