在Linux上，附加调试器时的崩溃、挂起或空白PDF

Curtis Chau

Updated: 2026年7月3日

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # 在Linux上，附加调试器时的崩溃、挂起或空白PDF 在Linux上，将调试器附加到您的应用程序可能会导致IronPDF挂起、返回空白PDF或静默崩溃。 这在调试器被附加时发生，无论Linux发行版或.NET版本如何。 IronPDF通过CEF（Chromium Embedded Framework）进行渲染，默认情况下会生成单独的、沙箱化的子进程以处理渲染。 在Linux上，这些子进程被锁定，因此无法使用`ptrace`进行跟踪，并且一个进程一次只能有一个跟踪器。附加调试器与Chromium启动其沙箱化子进程的方式发生冲突，因此渲染器子进程会挂起。 您的应用程序将其视为挂起、空白PDF或静默崩溃。 ## 解决方案 **推荐：启用单进程模式。** 在应用程序启动时设置它，在您的第一次IronPDF操作之前： ```csharp IronPdf.Installation.SingleProcess = true; ``` 单进程模式将渲染保持在主进程中，因此调试器没有沙箱化子进程可冲突。 由于该设置禁用了CEF的进程隔离，并且在负载下不够稳定，请不要在生产中使用。 将其限制在调试构建中，以便在发布中永不使用： ```csharp #if DEBUG IronPdf.Installation.SingleProcess = true; #endif ``` [[w:(单进程模式禁用了CEF的进程隔离，并且在负载下不够稳定。 在部署前将其移除或从发布构建中排除。)]]

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

在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

IronPdf.Installation.SingleProcess = True

单进程模式将渲染保持在主进程中，因此调试器没有沙箱化子进程可冲突。

由于该设置禁用了CEF的进程隔离，并且在负载下不够稳定，请不要在生产中使用。 将其限制在调试构建中，以便在发布中永不使用：

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...

阅读更多