Azure App Service Linux에서 Chrome 렌더러가 차가운 시작 시 실패함

해결책 1: 초기화 설정 적용 및 시작 타임아웃 증가

다음 초기화 코드를 애플리케이션 시작 시, PDF 렌더링 호출 전에 추가하세요:

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Option Strict 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 기본 이미지 업데이트로 인해 공유 라이브러리가 제거되는 경우에도 차가운 시작 실패를 일으키지 않습니다.