在Linux上附加除錯器會導致PDF崩潰、掛起或空白
Curtis Chau
已更新: 2026年7月3日
在Linux上,將除錯器附加到您的應用程式可能會導致IronPDF掛起、返回空白PDF或靜默崩潰。 無論Linux發行版或.NET版本如何,這種情況都會在附加除錯器時發生。
IronPDF透過CEF(Chromium Embedded Framework)進行渲染,預設情況下會產生分離的沙盒子程序來處理渲染。 在 Linux 上,這些子進程是被鎖定的,因此無法使用ptrace追蹤,而且一次只能有一個追蹤器附加在一個進程上。附加調試器與 Chromium 啟動其沙盒化子進程的方式相衝突,因此渲染子進程會掛起。 您的應用程式會將這視為掛起、空白PDF或靜默崩潰。
解決方案
建議:啟用單進程模式。 在應用程式啟動期間,在首次使用IronPDF之前設定它:
IronPdf.Installation.SingleProcess = true;IronPdf.Installation.SingleProcess = TrueIronPdf.Installation.SingleProcess = True單進程模式在主進程中保持渲染,因此沒有沙盒子程序與除錯器發生衝突。
因為該設置禁用了CEF的進程隔離,並且在負載下不太穩定,因此保持在生產環境之外。 將它範圍限定到除錯構建,因此它永遠不會被釋出交付:
#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif#If DEBUG Then
IronPdf.Installation.SingleProcess = True
#End If#If DEBUG Then
IronPdf.Installation.SingleProcess = True
#End If警告: 單進程模式禁用 CEF 的進程隔離,在負載下穩定性較差。 在部署之前,請移除它或排除出發布構建。
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。