IRONSOFTWAREHOME

在Linux上附加除錯器會導致PDF崩潰、掛起或空白

Curtis Chau
Curtis Chau
Updated: 2026年7月3日

在Linux上,將除錯器附加到您的應用程式可能會導致IronPDF掛起、返回空白PDF或靜默崩潰。 無論Linux發行版或.NET版本如何,這種情況都會在附加除錯器時發生。

IronPDF透過CEF(Chromium Embedded Framework)進行渲染,預設情況下會產生分離的沙盒子程式來處理渲染。 在Linux上,這些子程式被鎖定,所以不能用ptrace追蹤,一次只能有一個追蹤器。附加除錯器會與Chromium啟動其沙盒子程式的方式發生衝突,導致渲染器子程式掛起。 您的應用程式會將這視為掛起、空白PDF或靜默崩潰。

解決方案

建議:啟用單進程模式。 在應用程式啟動期間,在首次使用IronPDF之前設定它:

IronPdf.Installation.SingleProcess = true;

單進程模式在主進程中保持渲染,因此沒有沙盒子程式與除錯器發生衝突。

因為該設置禁用了CEF的進程隔離,並且在負載下不太穩定,因此保持在生產環境之外。 將它範圍限定到除錯構建,因此它永遠不會被釋出交付:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
C#
Warning: 單進程模式禁用了CEF的進程隔離,並且在負載下不太穩定。 在部署之前將它移除或從釋出構建中排除。
Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...
Read More

準備開始了嗎?

Nuget Downloads 20,389,208版本:2026.7剛剛發布

立即獲取您的免費30天試用密鑰
不需要信用卡或建立賬戶

免費試用IronPDF

5分鐘內設定完成

C# PDF DLL

下載DLL

立即下載

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置,位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器,右鍵點選參考。選擇瀏覽,"IronPdf.dll"
C# 用於PDF的NuGet程式庫

使用NuGet安裝

                  Install-Package IronPdf
                
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器,右鍵點選參考,管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝

授權從$999

有問題嗎?聯絡我們的開發團隊。

Key in blue circle

立即免費取得 30 天試用金鑰

bullet_checked無需信用卡或建立帳號
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge related to IronPDF Product Demo

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰
無需信用卡或帳戶建立