IronPDF Lambda 배포에서 누락된 종속성

Updated: 2026년 6월 10일

IronPDF가 AWS Lambda에 배포되면 다음과 유사한 오류가 발생하여 초기화에 실패합니다:

IronPDF failed to start: required native binaries not found at the expected path.
Unable to load shared library or one of its dependencies.
Error: Required IronPDF native dependencies were not found in the deployment package.

IronPDF failed to start: required native binaries not found at the expected path.
Unable to load shared library or one of its dependencies.
Error: Required IronPDF native dependencies were not found in the deployment package.

Text

Lambda 배포에서 누락된 기본 종속성은 다음 중 하나 이상으로 인해 발생합니다:

권한 부족: Lambda 실행 역할이나 파일 시스템 경로에 IronPDF가 필요로 하는 읽기/쓰기/실행 권한이 없습니다.
누락된 기본 바이너리: 기본 IronPDF 라이브러리가 배포 패키지에 포함되지 않았습니다.
잘못된 Dockerfile: Dockerfile이 Lambda 기본 이미지에 대한 올바른 OS 수준 종속성을 설치하지 않았습니다.

해결책

NuGet 패키지 IronPdf.Slim로 전환하세요. 전체 IronPDF 패키지와 달리, IronPdf.Slim는 실행 시 자동으로 감지된 베이스 이미지에 맞는 올바른 네이티브 바이너리를 다운로드하므로 플랫폼별 바이너리를 수동으로 번들할 필요가 없습니다:

// NuGet: IronPdf.Slim
// IronPdf.Slim selects and downloads the appropriate native runtime
// for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>");
pdf.SaveAs("/tmp/output.pdf");

// NuGet: IronPdf.Slim
// IronPdf.Slim selects and downloads the appropriate native runtime
// for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>");
pdf.SaveAs("/tmp/output.pdf");

' NuGet: IronPdf.Slim
' IronPdf.Slim selects and downloads the appropriate native runtime
' for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>")
pdf.SaveAs("/tmp/output.pdf")

' NuGet: IronPdf.Slim
' IronPdf.Slim selects and downloads the appropriate native runtime
' for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>")
pdf.SaveAs("/tmp/output.pdf")

Lambda에서 직접 테스트: 로컬 테스트를 의존하여 기본 종속성 해결을 검증하지 마십시오. 프로젝트를 로컬에서 실행하면 Lambda 호환 바이너리가 아닌 Windows 호환 또는 호스트 OS 호환 바이너리가 다운로드되어 잘못된 패스를 발생시킬 수 있습니다.

로그 파일 검색 네이티브의 진단 세부 사항을 위해 AWS에서 IronPdf.Slim로 전환 후 문제가 지속될 때. 최초 IronPDF 호출 전에 로깅을 활성화하십시오:

IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "/tmp/ironpdf.log";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "/tmp/ironpdf.log";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

Imports IronPdf.Logging

Logger.EnableDebugging = True
Logger.LogFilePath = "/tmp/ironpdf.log"
Logger.LoggingMode = Logger.LoggingModes.All

Imports IronPdf.Logging

Logger.EnableDebugging = True
Logger.LogFilePath = "/tmp/ironpdf.log"
Logger.LoggingMode = Logger.LoggingModes.All

지원 요청에 /tmp/ironpdf.log와 Lambda CloudWatch 로그 출력을 첨부하세요. 참조: Docker를 사용하여 IronPDF를 AWS Lambda로 배포하기 및 AWS에서 IronPDF 로그 파일 가져오는 방법.

Curtis Chau

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

기술 문서 작성자

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

...

더 읽어보기