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

업데이트됨:8월 20, 2025

Translated

View the article in English

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]

문제

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

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가 이 문제를 언제 해결할지는 아직 확정된 일정이 없습니다.

커티스 차우

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다