Azure App Service Linux'te Soğuk Başlatmada Chrome Renderer Başarısız Oluyor

Güncellendi:Haziran 9, 2026

Translated

View the article in English

Bu sorun, Azure App Service Linux'te, Azure'un altta yatan Oryx/Ubuntu tabanlı görüntüyü güncellemesi ve IronPDF'nin Chrome render'ının bağımlı olduğu paylaşılan kütüphaneleri kaldırmasıyla meydana gelir. Sonraki soğuk başlatmada, IronPDF bu yerel Chrome bağımlılıklarını sıfırdan yeniden yüklemek zorundadır, bu işlem 5 dakikaya kadar sürebilir. Uygulama başlatma zaman aşımı çok kısa olduğunda, kurulum kesintiye uğrar ve render başaramaz.

Hata genellikle şu şekilde görünür:

libnss3.so: cannot open shared object file: No such file or directory

Azure, App Service Linux ortamlarının kullandığı taban görüntüsünü periyodik olarak günceller. Bu güncellemeler, Chrome'un ihtiyaç duyduğu libnss3.so gibi paylaşılan kütüphaneleri kaldırabilir. Bu olduğunda, IronPDF'nin LinuxAndDockerDependenciesAutoConfig mekanizması, başlatma sırasında gerekli paketleri yeniden yüklemeye çalışır. Eğer servis zaman aşımı, bu yüklemeyi tamamlamak için gereken süreden kısa ise, işlem Chrome hazır olmadan önce kesilir.

Bu sorun, aşağıdaki ortamda doğrulandı:

Etkilenen sürüm: IronPDF 2026.4.1
Etkilenmeyen sürüm: IronPDF 2026.5.2
Barındırma: Azure App Service P0v3 planı, Norveç Doğu bölgesi
Çalışma zamanı: .NET 10

Çözüm

Çözüm 1: Başlatma ayarlarını uygulayın ve başlatma zaman aşımını artırın

Uygulama başlatmada, herhangi bir PDF render çağrısından önce, aşağıdaki başlatma kodunu ekleyin:

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()

$vbLabelText $csharpLabel

LinuxAndDockerDependenciesAutoConfig değerini true olarak ayarlamak, IronPDF'ye eksik Linux bağımlılıklarını otomatik olarak tespit edip yüklemesi gerektiğini söyler. ChromeGpuMode değerini IronPdf.Engines.Chrome.ChromeGpuModes.Disabled olarak ayarlamak, Azure App Service Linux ortamlarında bulunmayan GPU hızlandırmasını kapatır. Tam günlüklemeyi etkinleştirmek, bağımlılık yükleme adımında herhangi bir hatayı yakalamaya yardımcı olur.

Sonraki adım olarak, Azure App Service başlatma zaman aşımını en az 10 dakikaya artırın. Bu, Azure tabanlı görüntü güncellemesini takip eden soğuk başlatma sırasında IronPDF'nin bağımlılık yeniden yüklemesini tamamlamasına yetecek zamanı verir. App Service yapılandırmasında başlatma zamanı sınırlama ayarını nasıl ayarlayacağınıza dair talimatlar için Azure dağıtım kılavuzunu inceleyin.

Çözüm 2: IronPDF 2026.5.2'ye veya daha sonraki bir sürüme yükseltin

IronPDF 2026.5.2 veya daha sonraki bir sürüme yükseltilmesi bu sorunu çözer. Etkilenmeyen sürüm, Azure tabanlı görüntü güncellemelerinin paylaşılan kütüphaneleri kaldırdığı durumu, soğuk başlatma hatasına neden olmadan ele alır.

ÖnemliBu sorun IronPDF 2026.5.2'de çözüldü. Bu sürümde veya daha sonra iseniz, Çözüm 1'deki geçici çözümler artık gerekli değildir.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku

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

Nuget İndirmeler 20,088,359 | Sürüm: 2026.7 yeni yayınlandı