Travamento, bloqueio ou PDF em branco no Linux com um depurador conectado

Curtis Chau
Curtis Chau
Atualizado: 3 de julho de 2026

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 são bloqueados para que não possam ser rastreados com ptrace, e um processo pode ter apenas um rastreador por vez. Anexar um depurador colide com a maneira como o Chromium lança seus processos filho isolados, então 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;

O 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
Aviso: O modo de processo único desativa o isolamento de processo do CEF e é menos estável sob carga. Remova-o ou exclua-o das compilações de lançamento antes de implantar.

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 22,198,312Versão:2026.11recém-lançado