IronPDF Startup Crash z WEBSITE_RUN_FROM_PACKAGE
IronPDF może ulec awarii podczas uruchomienia na Azure App Service oraz Azure Functions, gdy aplikacja jest wdrożona z WEBSITE_RUN_FROM_PACKAGE = 1. To ustawienie montuje katalog główny aplikacji (C:\home\site\wwwroot) jako system plików tylko do odczytu, i skanowanie systemu plików przez IronPDF przy uruchomieniu kończy się niepowodzeniem, zazwyczaj przy pierwszym wywołaniu IronPDF, takim jak ustawienie klucza licencyjnego lub połączenie z zdalnym silnikiem.
System.IO.FileNotFoundException
To skanowanie nie jest czymś, czego IronPDF świadomie wymaga. Jest to efekt uboczny automatycznego ładowania rozszerzeń domyślnych przez Ninject. Ponieważ C:\home\site\wwwroot jest tylko do odczytu w WEBSITE_RUN_FROM_PACKAGE = 1, skanowanie rzuca FileNotFoundException i inicjalizacja zatrzymuje się przed rozpoczęciem jakiejkolwiek pracy z PDF.
To zostało naprawione w IronPDF 2026.8.1. Wcześniejsze wersje są dotknięte, w tym 2026.7.0.2, 2025.12.2, i 2025.3.6 na Windows (win-x64) pod .NET 10.
Rozwiązanie
Który krok jest potrzebny, zależy od tego, czy używasz zdalnego IronPdfEngine, czy natywnego IronPDF.
Remote IronPdfEngine i IronPdf.Slim
Zaktualizuj do IronPDF 2026.8.1 lub nowszej. Skanowanie przy uruchomieniu nie rzuca już wyjątku, więc WEBSITE_RUN_FROM_PACKAGE = 1 może pozostać włączone i nie są wymagane żadne inne zmiany. Renderowanie zachodzi na silniku, więc nie trzeba rozpakowywać natywnych binariów do katalogu głównego aplikacji tylko do odczytu.
Zobacz Użycie IronPDF w trybie in-Engine w celu konfiguracji połączenia.
Natywny IronPDF
Sama aktualizacja tutaj nie wystarcza. Przy uruchomieniu, natywny IronPDF wyodrębnia binaria renderera Chrome i biblioteki uruchomieniowe do zapisywalnej lokalizacji, a system tylko do odczytu C:\home\site\wwwroot blokuje tę ekstrakcję niezależnie od błędu skanowania powyżej.
W swoich ustawieniach aplikacji Azure, ustaw poniższe, a następnie wdroż ponownie:
WEBSITE_RUN_FROM_PACKAGE = 0
Wdrażasz z Visual Studio? Odznacz Uruchom z pliku pakietu (zalecane) podczas kroku Publikowania.

- W zależności od swojej ścieżki wdrożeniowej, to ustawienie może być stosowane z kilku różnych miejsc. Śledź, gdzie jest zdefiniowane i gdzie może być nadpisane.
- Aby zastosować zmianę: musisz wdrożyć ponownie. Samo ustawienie nie ma wpływu, dopóki aplikacja nie zostanie ponownie wdrożona.
Relokacja zapisywalnych ścieżek
Od 2026.8.1, gdy natywny silnik nie może wdrożyć swoich binariów Chromium i PDFium na systemie plików tylko do odczytu, błąd wdrożeniowy nazywa przyczynę i dostępne środki zaradcze zamiast powierzania niejasnej awarii w dół strumienia. Jednym z tych środków zaradczych jest skierowanie zapisywalnych ścieżek IronPDF poza montaż pakietu:
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\"Na Linux App Service użyj zamiast tego /home/data/ironsoftware/. Ustaw te przed pierwszym wywolaniem IronPDF. Jeśli renderer wciąż nie może się wdrożyć, ustaw WEBSITE_RUN_FROM_PACKAGE = 0 zgodnie z powyższym opisem.
Jeśli nie możesz zaktualizować
Na wersjach przed 2026.8.1, WEBSITE_RUN_FROM_PACKAGE = 0 jest jedynym niezawodnym rozwiązaniem zarówno dla natywnego silnika, jak i zdalnego silnika, ponieważ skanowanie przy uruchomieniu odbywa się przed osiągnięciem którejkolwiek ze ścieżek kodowych.
Dla więcej informacji, zobacz przewodnik Azure Linux WEBSITE_RUN_FROM_PACKAGE.
Obejścia, które nie działają w dotkniętych wersjach
Wszystkie te były próbowane w wersjach przed 2026.8.1, gdzie skanowanie odbywało się przed wszystkimi innymi procesami:
- Przeniesienie pierwszego wywołania IronPDF poza uruchomienie: awaria nadal występuje przy pierwszym użyciu z punktu końcowego na żądanie.
- Przełączanie pomiędzy
WEBSITE_RUN_FROM_ZIPaWEBSITE_RUN_FROM_PACKAGE: obie montują tylko do odczytu i nie działają w ten sam sposób. - Użycie zdalnego
IronPdfEngine: skanowanie przy uruchomieniu i tak działa jako pierwsze, więc niepowodzenie następuje przed użyciem zdalnego połączenia. To jest konkretne zachowanie, które2026.8.1naprawia. - Ustawienie
Installation.TempFolderPathna zapisywalną ścieżkę: awaria następuje przed odczytem tego ustawienia. Od2026.8.1ustawienie jest odczytywane normalnie.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.