IRONSOFTWAREHOME

AWS Lambda에서 세그멘테이션 오류 발생

Curtis Chau
Curtis Chau
Updated: 2026년 6월 29일

AWS Lambda를 Linux 컨테이너에서 사용하고 렌더링 메서드를 여러 번 동시에 호출할 때 다음과 같은 예외가 발생하는 경우가 있습니다.

예외:
오류: 런타임이 오류와 함께 종료되었습니다. 신호: 세그멘테이션 오류 Runtime.ExitError
Text

솔루션

해결책은 PDF 문서가 렌더링된 후 GC.Collect 메서드를 호출하는 것입니다. 이 문제는 최근 IronPDF 버전에서 Amazon Linux 2023에서 보고되었습니다; .NET 6 및 Amazon Linux 2를 사용하는 이전 배포는 영향을 받지 않습니다.

// Create an instance of ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render the HTML string to a PDF document
PdfDocument document = renderer.RenderHtmlAsPdf(htmlString);

// Explicitly trigger garbage collection to help manage memory usage
GC.Collect();

다중 프로세스 렌더링 및 wstring_convert::from_bytes 오류

GC.Collect()가 문제를 해결하지 못한다면, 근본 원인은 다중 프로세스 렌더링이나 Lambda 컨테이너 내에서 글로벌 ChromePdfRenderer 재사용일 수 있습니다. 이로 인해 세그먼트 결함이나 C++ 예외가 발생합니다:

Process runtime-1 exited: signal: segmentation fault
Error while generating PDF from HTML: 'wstring_convert::from_bytes'
Text

이 오류는 간헐적으로 발생하며, 첫 번째 또는 두 번째 Lambda 컨테이너 호출 이후에만 나타날 수 있습니다.

해결책

Installation.SingleProcess = true을 설정하고 경로를 /tmp로 리디렉션하며, 호출당 새로운 ChromePdfRenderer을 생성하세요:

IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.TempFolderPath = "/tmp";

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync(htmlString);

Installation.Initialize()을 호출하지 말고 ChromePdfRenderer을 정적 또는 필드 수준의 인스턴스로 유지하지 마세요. 지속적인 렌더러는 다음 Lambda 호출에서 오래된 메모리 상태를 가져와 크래시를 유발합니다.

// Avoid: global renderer reuse
private readonly ChromePdfRenderer _renderer = new();

// Avoid: calling Initialize()
Installation.Initialize();
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일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.