Troubleshooting Chrome Dependencies in IronPDF

Mis à jour:août 20, 2025

Translated

View the article in English

Le rendu HTML de Google Chromium est une partie essentielle du processus de rendu "Html to PDF" d'IronPDF. Le binaire essentiel pour ce rendu devrait être facilement trouvé dans le package NuGet d'IronPDF. L'absence de ce binaire du dossier du projet entraînera l'erreur suivante :

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

Si IronPDF est incapable de déployer automatiquement les dépendances Chrome, elles devront peut-être être ajoutées à un projet manuellement via NuGet. Plusieurs dépendances peuvent être ajoutées :

[{i :Dans les versions ultérieures d'IronPDF, les binaires requis seront automatiquement téléchargés à partir de la source NuGet en fonction du système d'exploitation utilisé pendant l'exécution, s'ils sont absents du dossier du projet. Cela réussira tant que le projet est connecté à Internet et qu'il dispose des autorisations de lecture, d'écriture et d'exécution sur le dossier du projet.)}]

Sous Windows, il est bon de s'assurer que le système d'exploitation cible a installé les runtimes Visual C++. De nombreuses applications modernes ne peuvent pas fonctionner sans ce composant essentiel du système d'exploitation.

We also have compatibility guides for Linux and Docker.

Linux

Assurez-vous que le bon fichier Docker est utilisé.
Utilisez le package NuGet IronPdf.Linux au lieu d'IronPdf.

Désactivez le mode GPU pour le rendu 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

Désactivez la configuration automatique pour les dépendances Linux et Docker :

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

Vérifiez que l'environnement d'exécution .NET est réglé sur la bonne architecture : x64 ou arm64.

Que faire si cela ne le résout pas ?

Si cela ne résout pas le problème, nous sommes là pour vous aider. La compatibilité est une priorité pour notre équipe d'ingénierie. Veuillez envoyer un rapport de bug par e-mail à support@ironsoftware.com. Tous les problèmes de compatibilité seront sérieusement examinés par un ingénieur principal.

Assurez-vous de nous informer du système d'exploitation/plateforme déployé, surtout s'il s'agit d'une plateforme cloud comme AWS ou Azure.

Comment activer la journalisation native dans IronPDF

Joindre des fichiers journaux à un rapport de bug plus que double la probabilité que nous puissions isoler le problème et le résoudre rapidement.

Placez cela en haut de votre code avant d'exécuter les méthodes d'IronPDF (toutes les versions après 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

Les fichiers journaux créés par IronPDF se trouvent dans le répertoire /bin de votre projet où vos DLL sont déployées :

default.log (processus de déploiement)
cef.log (rendue)
IronSoftwareCefSubprocess.log (rendue & threading)
IronSoftwareEngine.log (Utile pour déboguer les exceptions débutant par "Erreur lors de la génération du PDF à partir de...")

Les serveurs cloud ont souvent des emplacements spécifiques pour les fichiers journaux. We have guides for generating log files in Azure and AWS.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer?

Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir