IRONSOFTWAREHOME

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

Curtis Chau
Curtis Chau
Updated: 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 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;

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
C#
Aviso: O 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
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 bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 21,253,952Versão:2026.10recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.10

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 999

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Os seus dados serão sempre mantidos em sigilo.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Aprovado por milhões de engenheiros em todo o mundo.
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.10

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 999