Travamento, bloqueio ou PDF em branco no Linux com um depurador conectado
No Linux, conectar um depurador ao seu aplicativo pode deixar o IronPDF travado, retornar um PDF em branco ou travar silenciosamente. Isso acontece sempre que um depurador está conectado, independentemente da distribuição Linux ou da versão .NET.
O IronPDF processa através do CEF (Chromium Embedded Framework), que por padrão gera subprocessos separados e isolados para lidar com o processamento. No Linux, esses subprocessos estão bloqueados de forma que não podem ser rastreados com ptrace, e um processo pode ter apenas um rastreador por vez. Anexar um depurador colide com a forma como o Chromium lança seus subprocessos sandboxed, portanto, os subprocessos do renderizador travam. Seu aplicativo vê isso como um travamento, um PDF em branco ou uma falha silenciosa.
Solução
Recomendado: habilitar o modo de processo único. Defina isso durante a inicialização do aplicativo, antes de sua primeira operação IronPDF:
IronPdf.Installation.SingleProcess = true;IronPdf.Installation.SingleProcess = TrueO modo de processo único mantém o processamento no processo principal, de modo que não há subprocesso sandboxed para o depurador colidir.
Como essa configuração desativa o isolamento de processos do CEF e é menos estável sob carga, mantenha-a fora da produção. Restrinja-a a compilações de depuração para que nunca seja enviada em uma versão:
#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif

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.