IronPDF'de GPU Süreç Sorunları: Çözümler

Güncellendi:Ağustos 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 kullanırken, özellikle Azure'da dağıtırken buna benzer bir hata görüyorsanız, yalnız değilsiniz. Bu hata, uygulamanın çökmesine neden olduğu bilinir ve genellikle, IronPDF'nin önemli bir bileşeni olan yürütme zamanları klasöründe bulunan IronCefSubprocess.exe ile ilgilidir.

Olabilir Nedenler

Birden çok faktör bu GPU süreç hatasına neden olabilir. Aşağıda en sık rastlanan nedenlerden bazıları verilmiştir:

IronCefSubprocess için Eksik Yürütme İzinleri

IronPDF'nin ChromePdfRenderer sınıfını doğru şekilde başlatabilmesi için IronCefSubprocess.exe, yürütme izinlerine sahip olmalıdır.
Yanlış Azure Dağıtım Adımları

IronPDF'nin Azure üzerinde dağıtım işlemleri Linux ve Windows arasında farklılık gösterir. Yanlış adımlar izlemek bu hatayı tetikleyebilir.
Eksik DLL Bağımlılıkları

IronCefSubprocess.exe, doğru çalışması için belirli DLL dosyalarını gerektirir. Özellikle Windows dışı ortamda eksik DLL'ler süreç başarısız olmasına neden olabilir.

Çözüm

Yerel Ortam

Bu hatayı yerel olarak karşılaşıyorsanız, aşağıdaki adımları deneyin:

GPU Modunu Devre Dışı Bırakma

IronPDF için GPU modunu devre dışı bırakmak üzere şu satırı kodunuza ekleyin:

// 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

Yürütme İzinlerini Verme

IronCefSubprocess.exe'ın yürütme izinlerine sahip olduğundan emin olun. Linux sistemleri için şu komutu kullanın:

# 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

Eksik DLL'leri Kontrol Etme

Yukarıdaki adımlar sorunu çözmezse, eksik DLL'leri kontrol etmek için IronCefSubprocess.exe'i manuel olarak çalıştırın. Sistem, eksik DLL'yi belirten bir hata penceresi gösterecektir. Gereken DLL'i yükleyin ve uygulamayı yeniden çalıştırın.

Azure Dağıtımı

Hata uygulamanızı Azure'a dağıttıktan sonra ortaya çıkarsa, bu adımları izleyin:

ZipDeploy Kullanın

Tüm dosyaların doğru şekilde paketlendiğinden emin olmak için ZipDeploy kullanarak uygulamanızı dağıtın.
Paket Dosyasından Çalıştır'ı İşaretlemeyin

Dağıtım sırasında Paket Dosyasından Çalıştır seçeneğinin işaretli olmadığından emin olun.
Linux için Containerize Edin

Uygulamanız bir Linux ortamını hedefliyorsa, dağıtmadan önce Docker kullanarak containerize etmeyi düşünün. Detaylı talimatlar için Docker Kurulum Kılavuzuna bakın.

Tek İşlem Modunu Aktifleştirin

IronPDF'yi tek işlem modunda çalışmaya zorlamak için aşağıdaki kodu ekleyin:

// 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

Yukarıdaki çözümlerden hiçbiri sorunu çözmezse, kişiselleştirilmiş yardım için lütfen bir Mühendislik Talebi gönderin.

Curtis Chau

Mühendislik takımıyla şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku

Başlamaya Hazır mısınız?

Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı