Panne, suspension ou PDF vide sur Linux avec un débogueur attaché

Curtis Chau
Curtis Chau
Mis à jour : 3 juillet 2026

Sur Linux, attacher un débogueur à votre application peut laisser IronPDF suspendu, retourner un PDF vide ou se planter silencieusement. Cela se produit chaque fois qu'un débogueur est attaché, quel que soit le système de distribution Linux ou la version .NET.

IronPDF rend via CEF (Chromium Embedded Framework), qui par défaut crée des sous-processus séparés et isolés pour gérer le rendu. Sur Linux, ces sous-processus sont verrouillés de sorte qu'ils ne peuvent pas être tracés avec ptrace, et un processus ne peut avoir qu'un seul traceur à la fois. L'attachement d'un débogueur entre en collision avec la manière dont Chromium lance ses processus enfants dans un bac à sable, de sorte que les sous-processus de rendu se bloquent. Votre application voit cela comme un blocage, un PDF vide ou un plantage silencieux.

Solution

Recommandation : activez le mode monoprocédé. Configurez-le lors du démarrage de l'application, avant votre première opération IronPDF :

IronPdf.Installation.SingleProcess = true;

Le mode monoprocédé maintient le rendu dans le processus principal, de sorte qu'il n'y a pas d'enfant isolé pour entrer en collision avec le débogueur.

Étant donné que ce paramètre désactive l'isolation des processus du CEF et est moins stable sous charge, évitez de l'utiliser en production. Appliquez-le aux versions de débogage afin qu'il ne soit jamais inclus dans une version de sortie :

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
Avertissement: Le mode mono-processus désactive l'isolation des processus de CEF et est moins stable sous charge. Retirez-le ou excluez-le des builds de production avant le déploiement.

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 et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 22,198,312Version :2026.11tout juste publié