IronPDF Startup Crash z WEBSITE_RUN_FROM_PACKAGE

Curtis Chau
Curtis Chau
Zaktualizowano: 31 sierpnia 2026

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
Text

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
Text

Wdrażasz z Visual Studio? Odznacz Uruchom z pliku pakietu (zalecane) podczas kroku Publikowania.

Okno dialogowe publikacji Visual Studio z odznaczonym polem checkbox Running from package file (recommended)

  • 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\";

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_ZIP a WEBSITE_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óre 2026.8.1 naprawia.
  • Ustawienie Installation.TempFolderPath na zapisywalną ścieżkę: awaria następuje przed odczytem tego ustawienia. Od 2026.8.1 ustawienie 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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 22,198,312Wersja:2026.11właśnie wydane