IRONSOFTWAREHOME

IronPdf.LinuxARM: Não é possível alocar memória no bloco TLS estático

Curtis Chau
Curtis Chau
Updated: 21 de agosto de 2025

Ao usar a versão LinuxARM do IronPDF, aparece uma mensagem de exceção ao tentar carregar libcef.so no Linux ARM dinamicamente. E a seguinte mensagem de exceção seria exibida.

IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: '/irontest/testIronPdfOnLinuxArm/bin/Debug/net8.0/runtimes/linux-arm64/native/libcef.so: cannot allocate memory in static TLS block'. To learn more about making an engineering support request please visit: . To learn how to solve this issue please read https://ironpdf.com/troubleshooting/error-while-deploying-chrome-dependencies/ [Issue Code IRONPDF-CHROME-DEPLOYMENT-ERROR-LINUX]
Text

Problema

Ao carregar dinamicamente libcef.so no Linux ARM, você pode encontrar um erro que diz: "não é possível alocar memória no bloco TLS estático". Este erro é um problema reconhecido associado ao Chromium Embedded Framework (CEF). Isso ocorre porque as versões mais recentes do CEF exigem mais espaço de armazenamento local de threads (TLS) do que o vinculador dinâmico do Linux aloca por padrão. Este problema é bem documentado e afeta tanto processadores Linux ARM quanto sistemas Linux ARM x64, que ambos experimentam não ter armazenamento local de thread (TLS) suficiente para a versão mais recente do CEF. Você pode encontrar mais informações e a discussão sobre este assunto aqui .

Solução

A solução para essa exceção é configurá-la manualmente antes de executar o aplicativo, conforme mostrado abaixo.

export LD_PRELOAD=/path/to/libcef.so
SHELL

Definindo LD_PRELOAD manualmente antes do processo C#, forçamos o linker a carregar libcef.so primeiro, antes de outras bibliotecas, garantindo uma alocação suficiente de memória TLS. Essa abordagem tem se mostrado altamente eficaz, resolvendo o problema e prevenindo que falhe com erros TLS allocation. Você pode ter certeza de que essa solução funciona.

O método LD_PRELOAD é a abordagem mais eficaz e simples recomendada por outros usuários, incluindo os Fóruns CEF .

Esta é, por enquanto, uma solução alternativa até que a CEF resolva o problema para ARM, como fez para as versões x64 ao reduzir o uso de TLS na libxml2. No entanto, não há um prazo definido para quando a CEF resolverá isso.

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 20,756,830Versão:2026.7recé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.7

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

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$ 749

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.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
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.