デバッガーがアタッチされたLinuxでのクラッシュ、ハング、または空白のPDF

Curtis Chau
Curtis Chau
更新日: 2026年7月3日

Linuxで、デバッガーをアプリケーションにアタッチすることによりIronPDFがハングし、空白のPDFを返したり、静かにクラッシュすることがあります。 これは、どのLinuxディストリビューションや.NETバージョンでも、デバッガーがアタッチされるたびに発生します。

IronPDFはCEF(Chromium Embedded Framework)を通じてレンダリングします。これによりデフォルトで、レンダリングを処理するために個別のサンドボックス化されたサブプロセスを生成します。 Linuxでは、これらのサブプロセスは制限されており、ptraceでトレースすることはできません。また、プロセスには一度に1つのトレーサしか付けられません。デバッガをアタッチすると、Chromiumがサンドボックス化された子プロセスを起動する方法と衝突するため、レンダラーのサブプロセスがハングします。 アプリケーションはそれをハング、空白のPDF、または静かなクラッシュとして認識します。

解決策

推奨: シングルプロセスモードを有効にする。アプリケーションの起動時、最初のIronPDF操作の前にそれを設定します。

IronPdf.Installation.SingleProcess = true;

シングルプロセスモードでは、メインプロセスでレンダリングを維持し、デバッガーと衝突するためのサンドボックス化された子が存在しません。

その設定はCEFのプロセスアイソレーションを無効にし、負荷がかかると安定性が低いため、本番環境では使用しないでください。 デバッグビルドに限定し、リリースで絶対に出荷しないでください:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
警告: シングルプロセスモードは、CEFのプロセス分離を無効にし、負荷がかかると安定性が低下します。 削除するか、リリースビルドから除外してからデプロイしてください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 22,198,312バージョン:2026.11ちょうどリリースされました