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

Curtis Chau
Curtis Chau
更新: 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
警告: 单进程模式禁用CEF的进程隔离,并且在负载下稳定性较差。 在部署之前将其移除或从发布版本中排除。

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

阅读更多

准备开始了吗?

NuGet 下载量 22,198,312版本:2026.11刚刚发布