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

Atualizado:julho 2, 2026

Translated

View the article in English

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 = true;

IronPdf.Installation.SingleProcess = True

$vbLabelText $csharpLabel

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

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

#If DEBUG Then
    IronPdf.Installation.SingleProcess = True
#End If

$vbLabelText $csharpLabel

AvisoO modo de processo único desativa o isolamento de processos do CEF e é menos estável sob carga. Remova-o ou exclua-o das compilações de lançamento antes de implantar.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

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 ...