IronPDF에서 발생하는 GPU 프로세스 문제: 해결 방법

업데이트됨:8월 20, 2025

Translated

View the article in English

[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가 IronCefSubprocess.exe 클래스를 제대로 초기화하려면 ChromePdfRenderer에 실행 권한이 있어야 합니다.
잘못된 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;

$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 파일이 있는지 확인하십시오.

위의 단계를 수행해도 문제가 해결되지 않으면 IronCefSubprocess.exe를 수동으로 실행하여 누락된 DLL이 있는지 확인하십시오. 시스템은 누락된 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;

$vbLabelText $csharpLabel

위의 해결 방법으로 문제가 해결되지 않으면 맞춤형 지원을 위해 엔지니어링 요청을 제출해 주세요.

커티스 차우

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

기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다