IronPDF-Startabsturz mit WEBSITE_RUN_FROM_PACKAGE
IronPDF kann beim Start auf Azure App Service und Azure Functions abstürzen, wenn die App mit WEBSITE_RUN_FROM_PACKAGE = 1 bereitgestellt wurde. Diese Einstellung bindet das App-Root (C:\home\site\wwwroot) als schreibgeschütztes Paketdateisystem ein und der Start-Dateisystemscan von IronPDF schlägt dagegen fehl, normalerweise beim ersten IronPDF-Aufruf wie dem Setzen des Lizenzschlüssels oder der Verbindung zu einer Remote-Engine.
System.IO.FileNotFoundException
Der Scan ist nichts, was IronPDF absichtlich erfordert. Es ist ein Nebeneffekt des Standard-Extensions-Auto-Ladens von Ninject. Da C:\home\site\wwwroot unter WEBSITE_RUN_FROM_PACKAGE = 1 schreibgeschützt ist, löst der Scan FileNotFoundException aus und die Initialisierung stoppt, bevor irgendeine PDF-Arbeit ausgeführt wird.
Dies ist in IronPDF 2026.8.1 behoben. Frühere Versionen sind betroffen, einschließlich 2026.7.0.2, 2025.12.2 und 2025.3.6 unter Windows (win-x64) unter .NET 10.
Lösung
Welcher Schritt erforderlich ist, hängt davon ab, ob Sie die Remote-IronPdfEngine oder das native IronPDF ausführen.
Remote IronPdfEngine und IronPdf.Slim
Update auf IronPDF 2026.8.1 oder später. Der Start-Scan wirft nicht mehr, sodass WEBSITE_RUN_FROM_PACKAGE = 1 aktiviert bleiben kann und keine weiteren Änderungen erforderlich sind. Das Rendering erfolgt auf der Engine, sodass keine nativen Binärdateien in das schreibgeschützte App-Root extrahiert werden müssen.
Siehe Verwendung von IronPDF im In-Engine-Modus für die Verbindungseinrichtung.
Native IronPDF
Ein Upgrade allein ist hier nicht ausreichend. Beim Start extrahiert das native IronPDF die Chrome-Renderer-Binärdateien und Laufzeitbibliotheken in einen beschreibbaren Speicherort, und ein schreibgeschütztes C:\home\site\wwwroot blockiert diese Extraktion unabhängig vom obigen Scan-Fehler.
In Ihren Azure-App-Einstellungen setzen Sie das Folgende und stellen dann erneut bereit:
WEBSITE_RUN_FROM_PACKAGE = 0
Bereitstellung von Visual Studio? Deaktivieren Sie Aus Paketdatei ausführen (empfohlen) während des Veröffentlichungsschrittes.

- Je nach Ihrer Bereitstellungspipeline kann diese Einstellung an mehreren verschiedenen Stellen angewendet werden. Verfolgen Sie, wo sie definiert ist und wo sie überschrieben werden könnte.
- Um die Änderung anzuwenden: Sie müssen erneut bereitstellen. Die Einstellung allein hat keine Wirkung, bis die App erneut bereitgestellt wird.
Verlagerung der beschreibbaren Pfade
Ab 2026.8.1, wenn die native Engine ihre Chromium- und PDFium-Binärdateien nicht auf einem schreibgeschützten Dateisystem bereitstellen kann, benennt der Bereitstellungsfehler die Ursache und die verfügbaren Abhilfen anstelle eines unklaren downstream-Fehlers. Eine dieser Abhilfen ist, die beschreibbaren Pfade von IronPDF außerhalb der Paketmontage zu verweisen:
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\"Auf Linux App Service verwenden Sie stattdessen /home/data/ironsoftware/. Setzen Sie diese vor dem ersten IronPDF-Aufruf. Wenn der Renderer immer noch nicht bereitgestellt werden kann, setzen Sie WEBSITE_RUN_FROM_PACKAGE = 0 wie oben beschrieben.
Wenn Sie nicht upgraden können
In Versionen vor 2026.8.1 ist WEBSITE_RUN_FROM_PACKAGE = 0 die einzige zuverlässige Lösung sowohl für die native als auch für die Remote-Engine, da der Start-Scan ausgeführt wird, bevor einer der Codepfade erreicht wird.
Für weitere Hintergrundinformationen siehe den Azure Linux WEBSITE_RUN_FROM_PACKAGE-Leitfaden.
Umgehungen, die bei betroffenen Versionen nicht funktionieren
Diese wurden alle gegen Versionen vor 2026.8.1 ausprobiert, bei denen der Scan vor allem anderen ausgeführt wird:
- Verschieben des ersten IronPDF-Aufrufs aus dem Start: der Absturz tritt trotzdem beim ersten Gebrauch von einem nach Bedarf-Endpunkt auf.
- Wechseln zwischen
WEBSITE_RUN_FROM_ZIPundWEBSITE_RUN_FROM_PACKAGE: beide hängen schreibgeschützt ein und scheitern auf dieselbe Weise. - Verwendung der Remote-
IronPdfEngine: der Start-Scan wird immer noch zuerst ausgeführt, sodass es fehlschlägt, bevor die Remote-Verbindung verwendet wird. Dies ist das spezifische Verhalten, das2026.8.1behebt. - Setzen von
Installation.TempFolderPathauf einen beschreibbaren Pfad: der Absturz tritt auf, bevor diese Einstellung gelesen wird. Ab2026.8.1wird die Einstellung normal gelesen.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.