IRONSOFTWAREHOME

IronPdf.LinuxARM: 정적 TLS 블록에 메모리를 할당할 수 없습니다.

Curtis Chau
Curtis Chau
Updated: 2025년 8월 21일

LinuxARM 버전의 IronPDF를 사용할 때, Linux ARM에서 libcef.so을 동적으로 로드하려고 하면 예외 메시지가 나타납니다. 그러면 다음과 같은 예외 메시지가 나타납니다.

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

문제

Linux ARM에서 libcef.so을 동적으로 로드할 때, "정적 TLS 블록에서 메모리를 할당할 수 없습니다."라는 오류가 발생할 수 있습니다. 이 오류는 Chromium Embedded Framework (CEF)와 관련된 문제로 확인되었습니다. 이 문제는 CEF의 최신 버전이 리눅스 동적 링커가 기본적으로 할당하는 것보다 더 많은 스레드 로컬 스토리지(TLS) 공간을 요구하기 때문에 발생합니다. 이 문제는 잘 문서화됐으며, Linux ARM 프로세서와 Linux ARM x64 시스템 모두에 영향을 미치며, 더 새로운 CEF 버전에 충분한 스레드 로컬 저장소(TLS)가 없습니다. 이 문제에 대한 더 자세한 정보와 논의는 여기에서 확인할 수 있습니다.

해결책

이 예외를 해결하는 방법은 아래와 같이 애플리케이션을 실행하기 전에 수동으로 설정하는 것입니다.

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

C# 프로세스 전에 LD_PRELOAD를 수동으로 설정하여 링크가 다른 라이브러리보다 먼저 libcef.so을 로드하도록 강제하면 충분한 TLS 메모리 할당을 보장할 수 있습니다. 이 접근 방식은 매우 효과적인 것으로 입증되었으며, 문제를 해결하고 TLS allocation 오류가 발생하지 않도록 방지합니다. 이 해결책이 효과가 있다는 것을 확신하셔도 됩니다.

LD_PRELOAD 방식은 CEF 포럼을 포함한 다른 사용자들이 권장하는 가장 효과적이고 간단한 접근 방식입니다.

이는 CEF가 x64 빌드에서 libxml2의 TLS 사용량을 줄여 ARM용 문제를 해결했던 것처럼, ARM용 문제도 해결할 때까지의 임시 해결책입니다. 하지만 CEF가 이 문제를 언제 해결할지는 아직 확정된 일정이 없습니다.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.