IRONSOFTWAREHOME

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

Curtis Chau
Curtis Chau
Updated: 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. Attacher un débogueur entre en conflit avec la façon dont Chromium lance ses sous-processus isolés, donc les sous-processus du moteur 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
C#
Avertissement: Le mode monoprocédé désactive l'isolation des processus du CEF et est moins stable sous charge. Retirez-le ou excluez-le des builds de sortie avant le déploiement.
Curtis Chau
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 et créer des manuels bien structurés et visuellement attrayants.

...
Lire la suite

Prêt à commencer ?

Nuget Downloads 21,253,952Version :2026.10vient de sortir

Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise
Bibliothèque C# NuGet pour PDF
Installer avec NuGet

Version : 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Dans l'explorateur de solutions, faites un clic droit sur Références, Gestion des packages NuGet
  2. Sélectionnez Parcourir et recherchez « IronPDF »
  3. Sélectionnez le package et installez
C# PDF DLL
Télécharger DLL

Version : 2026.10

ou téléchargez l'installateur Windows ici.

  1. Téléchargez et décompressez IronPDF à un emplacement tel que ~/Libs dans votre répertoire de solution
  2. Dans l'explorateur de solutions Visual Studio, faites un clic droit sur Références. Sélectionnez Parcourir, « IronPDF.dll »

Licences à partir de 999 $

Vous avez une question ? Contactez notre équipe de développement.

Key in blue circle

Obtenez votre clé d'essai de 30 jours instantanément.

Your trial license will be sent to your email address

Aucune restriction. 100 % débloqué. Pas de carte bancaire.

bullet_checkedAucune carte de crédit ou création de compte requiseAucune restriction. 100 % débloqué. Pas de carte bancaire.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Réservez votre Démonstration en direct gratuite
Booking Badge

De confiance par des millions d'ingénieurs dans le monde entier

Logos des clients d'Iron Software
Obtenez Votre Consultation sans Engagement
Vos informations seront toujours gardées confidentielles.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
De confiance par des millions d'ingénieurs dans le monde entier
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise
Bibliothèque C# NuGet pour PDF
Installer avec NuGet

Version : 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Dans l'explorateur de solutions, faites un clic droit sur Références, Gestion des packages NuGet
  2. Sélectionnez Parcourir et recherchez « IronPDF »
  3. Sélectionnez le package et installez
C# PDF DLL
Télécharger DLL

Version : 2026.10

ou téléchargez l'installateur Windows ici.

  1. Téléchargez et décompressez IronPDF à un emplacement tel que ~/Libs dans votre répertoire de solution
  2. Dans l'explorateur de solutions Visual Studio, faites un clic droit sur Références. Sélectionnez Parcourir, « IronPDF.dll »

Licences à partir de 999 $