IRONSOFTWAREHOME

IronPdf.LinuxARM: Speicherzuweisung im statischen TLS-Block nicht möglich

Curtis Chau
Curtis Chau
Updated: 21. August 2025

Beim Verwenden der LinuxARM-Version von IronPDF erscheint eine Ausnahme-Nachricht beim Versuch, libcef.so dynamisch auf Linux ARM zu laden. Und die folgende Fehlermeldung würde erscheinen.

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

Problem

Beim dynamischen Laden von libcef.so auf Linux ARM können Sie auf einen Fehler stoßen, der besagt: "cannot allocate memory in static TLS block." Dieser Fehler ist ein anerkanntes Problem, das mit dem Chromium Embedded Framework (CEF) verbunden ist. Er tritt auf, weil neuere Versionen von CEF mehr Speicherplatz für Thread Local Storage (TLS) benötigen, als der Linux-Dynamik-Linker standardmäßig zuweist. Dieses Problem ist gut dokumentiert und betrifft sowohl Linux-ARM-Prozessoren als auch Linux-ARM-x64-Systeme, denen sowohl der Thread Local Storage (TLS) für die neuere Version des CEF fehlt. Weitere Informationen und die Diskussion zu diesem Thema finden Sie hier.

Lösung

Die Lösung für diese Ausnahme besteht darin, sie manuell festzulegen, bevor Sie Ihre Anwendung ausführen, wie unten gezeigt.

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

Indem Sie manuell LD_PRELOAD vor dem C#-Prozess setzen, erzwingen wir, dass der Linker libcef.so zuerst lädt, vor anderen Bibliotheken, um eine ausreichende TLS-Speicherzuteilung sicherzustellen. Dieser Ansatz hat sich als sehr effektiv erwiesen und löst das Problem, indem er verhindert, dass es mit TLS allocation-Fehlern scheitert. Sie können sicher sein, dass diese Lösung funktioniert.

Die LD_PRELOAD-Methode ist der effektivste und einfachste Ansatz, der von anderen Nutzern, einschließlich der CEF Foren, empfohlen wird.

Dies ist derzeit ein Workaround, bis CEF das Problem für ARM schließlich löst, wie es für die x64-Kompilierungen durch die Reduzierung der TLS-Nutzung in libxml2 getan wurde. Es gibt jedoch keinen klar definierten Zeitplan, wann CEF dies angehen wird.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...
Weiterlesen

Bereit anzufangen?

Nuget Downloads 21,253,952Version:2026.10gerade veröffentlicht

Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.10

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 999 $

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Ihre Daten werden immer vertraulich behandelt.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Von Millionen von Ingenieur*innen weltweit vertraut
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.10

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 999 $