IronPDF 에서 발생하는 GPU 프로세스 문제 해결 방법
[0110/094441.173:ERROR:network_service_instance_impl.cc(521)] Network service crashed, restarting service.
[0110/094442.261:ERROR:gpu_process_host.cc(990)] GPU process exited unexpectedly: exit_code=255
[0110/094442.261:WARNING:gpu_process_host.cc(1337)] The GPU process has crashed 3 time(s)
[0110/094442.261:FATAL:gpu_data_manager_impl_private.cc(440)] GPU process isn't usable. Goodbye.
IronPDF 사용하면서, 특히 Azure에 배포할 때 위와 유사한 오류가 발생하는 경우, 여러분만 그런 것이 아닙니다. 이 오류는 IronPDF의 중요한 구성 요소인 런타임 폴더에 위치한 IronCefSubprocess.exe와 관련이 있으며, 보통 애플리케이션을 멈추게 합니다.
가능한 원인
이러한 GPU 프로세스 오류는 여러 요인에 의해 발생할 수 있습니다. 다음은 가장 흔한 원인 몇 가지입니다.
-
IronCefSubprocess에 대한 실행 권한이 누락되었습니다 .
IronPDF가
ChromePdfRenderer클래스를 적절히 초기화하려면IronCefSubprocess.exe에 실행 권한이 있어야 합니다. -
잘못된 Azure 배포 단계
Azure에서 IronPDF 의 배포 프로세스는 Linux와 Windows 환경에서 서로 다릅니다. 잘못된 절차를 따르면 이 오류가 발생할 수 있습니다.
-
누락된 DLL 종속성
IronCefSubprocess.exe는 올바르게 실행되기 위해 특정 DLL 파일이 필요합니다. 특히 Windows 이외의 환경에서 DLL 파일이 누락되면 프로세스가 실패할 수 있습니다.
해결책
지역 환경
로컬 환경에서 이 오류가 발생하는 경우 다음 단계를 시도해 보세요.
-
GPU 모드 비활성화
IronPDF 의 GPU 모드를 비활성화하려면 코드에 다음 줄을 추가하십시오.
// Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;// Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;' Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled$vbLabelText $csharpLabel -
실행 권한 부여
IronCefSubprocess.exe에 실행 권한이 있는지 확인하십시오. 리눅스 시스템의 경우 다음 명령어를 사용하십시오.# Grants execute permissions to IronCefSubprocess.exe chmod 755 IronCefSubprocess # You may need to specify an exact path # IronCefSubprocess is typically found at bin/runtimes/linux-x64/ # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess # In some cases you may need to use chmod 777 for broader permissions.# Grants execute permissions to IronCefSubprocess.exe chmod 755 IronCefSubprocess # You may need to specify an exact path # IronCefSubprocess is typically found at bin/runtimes/linux-x64/ # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess # In some cases you may need to use chmod 777 for broader permissions.SHELL -
누락된 DLL 파일이 있는지 확인하십시오.
위의 단계로 문제가 해결되지 않으면, 누락된 DLL을 확인하기 위해
IronCefSubprocess.exe을 수동으로 실행하십시오. 시스템은 누락된 DLL을 알려주는 오류 상자를 표시합니다. 필요한 DLL 파일을 설치하고 애플리케이션을 다시 실행하십시오.
Azure 배포
Azure에 앱을 배포한 후 오류가 발생하는 경우 다음 단계를 따르세요.
-
ZipDeploy를 사용하세요
ZipDeploy를 사용하여 애플리케이션을 배포하면 모든 파일이 올바르게 패키징됩니다.
-
패키지 파일에서 실행 옵션을 해제합니다 .
배포 시 '패키지 파일에서 실행' 옵션이 선택 해제되어 있는지 확인하십시오.
-
Linux용 컨테이너화
애플리케이션이 Linux 환경을 대상으로 하는 경우 Azure에 배포하기 전에 Docker를 사용하여 컨테이너화하는 것을 고려하십시오. 자세한 지침은 Docker 설정 가이드를 참조하십시오.
-
단일 프로세스 모드 활성화
IronPDF 단일 프로세스 모드로 실행하도록 하려면 다음 코드를 추가하십시오.
// Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = true;// Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = true;' Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = True$vbLabelText $csharpLabel
위의 해결 방법으로 문제가 해결되지 않으면 맞춤형 지원을 위해 엔지니어링 요청을 제출해 주세요.

