Azure App Service Linux에서 Chrome 렌더러가 차가운 시작 시 실패함
이 문제는 Azure가 기본 Oryx/Ubuntu 이미지를 업데이트하여 IronPDF의 Chrome 렌더러가 필요로 하는 공유 라이브러리를 제거할 때 Azure App Service Linux에서 발생합니다. 다음 차가운 시작 시, IronPDF는 처음부터 이 네이티브 Chrome 종속성을 다시 설치해야 하며, 이 과정은 최대 5분이 걸릴 수 있습니다. 애플리케이션 시작 타임아웃이 너무 짧으면 설치가 중단되고 렌더러가 실패합니다.
오류는 일반적으로 다음과 같이 나타납니다:
libnss3.so: cannot open shared object file: No such file or directoryAzure는 App Service Linux 환경에서 사용되는 기본 이미지를 주기적으로 업데이트합니다. 이 업데이트는 Chrome이 필요로 하는 libnss3.so와 같은 공유 라이브러리를 제거할 수 있습니다. 이 경우 IronPDF의 LinuxAndDockerDependenciesAutoConfig 메커니즘은 시작 시 필요한 패키지를 다시 설치하려고 시도합니다. 서비스 타임아웃이 이 설치를 완료하는 데 필요한 시간보다 짧으면 프로세스가 Chrome이 준비되기 전에 중단됩니다.
이 문제는 다음 환경에서 확인되었습니다:
- 영향받은 버전: IronPDF 2026.4.1
- 영향받지 않은 버전: IronPDF 2026.5.2
- 호스팅: Azure App Service P0v3 플랜, 노르웨이 동부 지역
- 런타임: .NET 10
해결책
해결책 1: 초기화 설정 적용 및 시작 타임아웃 증가
다음 초기화 코드를 애플리케이션 시작 시, PDF 렌더링 호출 전에 추가하세요:
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()IronPDF에게 누락된 Linux 종속성을 자동으로 감지 및 설치하도록 지시하는 LinuxAndDockerDependenciesAutoConfig을 true로 설정합니다. Azure App Service Linux 환경에서 사용할 수 없는 GPU 가속을 끄기 위해 ChromeGpuMode을 IronPdf.Engines.Chrome.ChromeGpuModes.Disabled로 설정합니다. 전체 로깅을 활성화하면 종속성 설치 단계에서 발생할 수 있는 오류를 캡처하는 데 도움이 됩니다.
다음으로 Azure App Service 시작 타임아웃을 최소 10분으로 늘리십시오. 이는 Azure 기본 이미지 업데이트 후 차가운 시작 시 IronPDF가 종속성 재설치를 완료할 수 있는 충분한 시간을 제공합니다. App Service 구성에서 시작 시간 제한을 조정하는 방법은 Azure 배포 가이드를 참조하세요.
해결책 2: IronPDF 2026.5.2 이상으로 업그레이드하기
IronPDF 2026.5.2 또는 그 이후 버전으로 업그레이드하면 이 문제가 해결됩니다. 영향받지 않은 버전은 Azure 기본 이미지 업데이트로 인해 공유 라이브러리가 제거되는 경우에도 차가운 시작 실패를 일으키지 않습니다.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.
