IronPDF, WEBSITE_RUN_FROM_PACKAGE ile Başlangıç Çökmesi
IronPDF, uygulama WEBSITE_RUN_FROM_PACKAGE = 1 ile dağıtıldığında Azure App Service ve Azure Functions üzerinde başlangıçta çökebilir. Bu ayar, uygulama kökünü (C:\home\site\wwwroot) salt okunur bir paket dosya sistemi olarak monte eder ve IronPDF'in başlangıç dosya sistemi taraması, genellikle lisans anahtarının ayarlanması veya uzak bir motora bağlanılması gibi ilk IronPDF çağrısında başarısız olur.
System.IO.FileNotFoundException
Tarama, IronPDF'in kasıtlı olarak ihtiyaç duyduğu bir şey değildir. Bu, Ninject'in varsayılan uzantı otomatik yüklemesinin bir yan etkisidir. C:\home\site\wwwroot, WEBSITE_RUN_FROM_PACKAGE = 1 altında salt okunur olduğundan, tarama FileNotFoundException fırlatır ve herhangi bir PDF çalışması başlamadan önce başlatma durur.
Bu, IronPDF 2026.8.1 içinde düzeltilmiştir. Önceki sürümler etkilenir, 2026.7.0.2, 2025.12.2 ve 2025.3.6 Windows üzerinde (win-x64) .NET 10 altında dahil olmak üzere.
Çözüm
Hangi adımı atmanız gerektiği, uzak IronPdfEngine'i mi yoksa yerel IronPDF'i mi çalıştırdığınıza bağlıdır.
Uzak IronPdfEngine ve IronPdf.Slim
IronPDF 2026.8.1 veya daha üst bir sürüme yükseltin. Başlangıç taraması artık fırlatmaz, bu yüzden WEBSITE_RUN_FROM_PACKAGE = 1 etkin bırakılabilir ve başka bir değişiklik gerekmez. Render işlemi motorda gerçekleşir, bu nedenle salt okunur uygulama köküne herhangi bir yerel ikili dosya çıkarılmasına gerek yoktur.
IronPDF'i Motor İçi Modda Kullan bağlantısı için kurulum.
Yerel IronPDF
Burada yalnızca yükseltme yeterli değildir. Başlangıçta, yerel IronPDF Chrome render dosyalarını ve çalışma zamanı kütüphanelerini yazılabilir bir konuma çıkarır ve salt okunur C:\home\site\wwwroot, yukarıdaki tarama hatasından bağımsız olarak bu çıkarımı engeller.
Azure Uygulama Ayarlarınızda aşağıdakileri ayarlayın ve ardından yeniden dağıtın:
WEBSITE_RUN_FROM_PACKAGE = 0
Visual Studio'dan mı dağıtıyorsunuz? Yayınlama adımında Paket dosyasından çalıştır (önerilir) seçeneğinin işaretini kaldırın.

- Dağıtım hattınıza bağlı olarak, bu ayar birden fazla yerden uygulanabilir. Tanımlandığı ve nerede üzerine yazılabileceğini takip edin.
- Değişikliği uygulamak için: yeniden dağıtmanız gerekecek. Ayarlama tek başına uygulama yeniden dağıtılana kadar bir etkisi yoktur.
Yazılabilir Yolların Taşınması
2026.8.1 itibarıyla, yerel motor, salt okunur bir dosya sisteminde Chromium ve PDFium ikili dosyalarını dağıtamazsa, dağıtım hatası belirsiz bir alt uç başarısızlık yerine nedeni ve mevcut çözümleri belirtir. Bu çözümlerden biri, IronPDF'in yazılabilir yollarını paket montajının dışına işaret etmektir:
IronPdf.Installation.TempFolderPath = @"D:\home\data\ironsoftware\";
IronPdf.Installation.CustomDeploymentDirectory = @"D:\home\data\ironsoftware\";IronPdf.Installation.TempFolderPath = "D:\home\data\ironsoftware\"
IronPdf.Installation.CustomDeploymentDirectory = "D:\home\data\ironsoftware\"IronPdf.Installation.TempFolderPath = "D:\home\data\ironsoftware\"
IronPdf.Installation.CustomDeploymentDirectory = "D:\home\data\ironsoftware\"Linux Uygulama Hizmeti üzerinde, bunun yerine /home/data/ironsoftware/ kullanın. Bunları ilk IronPDF çağrısından önce ayarlayın. Render hala dağıtılamıyorsa, yukarıda açıklandığı gibi WEBSITE_RUN_FROM_PACKAGE = 0 ayarlayın.
Yükseltemezseniz
2026.8.1 öncesi sürümlerde WEBSITE_RUN_FROM_PACKAGE = 0, yerel motor ve uzak motor için tek güvenilir çözümdür, çünkü başlangıç taraması her iki kod yoluna ulaşılmadan önce çalışır.
Daha fazla arka plan için Azure Linux WEBSITE_RUN_FROM_PACKAGE rehberina bakın.
Etkilenen Sürümlerde Çalışmayan Çözümler
Bunlar, her şeyin önünde çalışan taramanın olduğu 2026.8.1 öncesindeki sürümlerde denenmiştir:
- İlk IronPDF çağrısını başlangıçtan çıkarmak: çökme, isteğe bağlı bir uç noktadan ilk kullanımda hala meydana gelir.
WEBSITE_RUN_FROM_ZIPveWEBSITE_RUN_FROM_PACKAGEarasında geçiş yapmak: her ikisi de salt okunur olarak monte edilir ve aynı şekilde başarısız olur.- Uzak
IronPdfEnginekullanmak: başlangıç taraması ilk önce çalışır, bu yüzden uzak bağlantı kullanılmadan önce başarısız olur. Bu,2026.8.1adlı belirli davranışın düzeltmesidir. Installation.TempFolderPath'u yazılabilir bir yola ayarlamak: çökme, bu ayar okunmadan önce meydana gelir.2026.8.1'dan itibaren ayar normal şekilde okunur.
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ılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.