1. IronPDF
  2. 故障排除
  3. 在Linux上附加偵錯器時，程式崩潰、卡頓或空白PDF

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

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

解決方案

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

IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.SingleProcess = True
$vbLabelText   $csharpLabel

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

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

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
#If DEBUG Then
    IronPdf.Installation.SingleProcess = True
#End If
$vbLabelText   $csharpLabel

警告單進程模式禁用了CEF的進程隔離，並且在負載下不太穩定。 在部署之前將它移除或從釋出構建中排除。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。