IronPDF在使用WEBSITE_RUN_FROM_PACKAGE時啟動崩潰
當應用程式是用WEBSITE_RUN_FROM_PACKAGE = 1部署在Azure App Service和Azure Functions時,IronPDF可能會在啟動時崩潰。 該設置將應用程式根目錄(C:\home\site\wwwroot)掛載為只讀的包文件系統,IronPDF的啟動文件系統掃描在該系統上會失敗,通常在第一次IronPDF調用(如設置授權金鑰或連接到遠程引擎)時發生。
System.IO.FileNotFoundException
該掃描並非IronPDF故意要求。 它是Ninject的默認擴展自動加載的副作用。 由於C:\home\site\wwwroot在WEBSITE_RUN_FROM_PACKAGE = 1下是唯讀的,掃描拋出FileNotFoundException,並且在任何PDF工作運行之前初始化停止。
這在IronPDF 2026.8.1中已修復。 早期版本也受到影響,包括2026.7.0.2、2025.12.2和在Windows上的2025.3.6(win-x64)於.NET 10下。
解決方案
您需要採取的步驟取決於您是否運行遠程IronPdfEngine或本地IronPDF。
遠程IronPdfEngine和IronPdf.Slim
升級到IronPDF 2026.8.1或更高版本。 啟動掃描不再拋出錯誤,因此WEBSITE_RUN_FROM_PACKAGE = 1可以保持啟用狀態,且不需要其他更改。 渲染在引擎中發生,因此不需要提取本地二進制文件到只讀的應用程式根目錄中。
參見使用引擎模式使用IronPDF來進行連接設置。
本地IronPDF
僅升級是不夠的。 在啟動時,本地IronPDF會將Chrome渲染器的二進制文件和運行庫提取到一個可寫位置,而只讀的C:\home\site\wwwroot會獨立於上述掃描錯誤阻止該提取。
在您的Azure App Settings中,請設置以下內容,然後重新部署:
WEBSITE_RUN_FROM_PACKAGE = 0
從Visual Studio部署嗎? 在發佈步驟中,取消勾選從包文件運行(建議)。

- 根據您的部署管道,這個設置可以從幾個不同地方應用。 追蹤它是在哪裡定義的,以及可能被覆蓋的地方。
- 要應用更改:您必須重新部署。 僅有該設置不會有所影響,直到應用重新部署。
重定位可寫的路徑
從2026.8.1開始,當本地引擎無法在只讀文件系統上部署其Chromium和PDFium二進制文件時,部署錯誤會命名原因和可用的修復方法,而不是讓不清楚的下游失敗浮現。 這些修復方法之一是將IronPDF的可寫路徑指向包掛載外的某處:
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 App Service上,請改用/home/data/ironsoftware/。 在第一次 IronPDF 呼叫之前設置這些。 如果渲染器仍然無法部署,請根據上文所述設置WEBSITE_RUN_FROM_PACKAGE = 0。
如果您無法升級
在2026.8.1之前的版本中,WEBSITE_RUN_FROM_PACKAGE = 0是本地引擎和遠程引擎唯一可靠的修復,因為啟動掃描在任何代碼路徑到達之前運行。
有關更多背景知識,請參見Azure Linux WEBSITE_RUN_FROM_PACKAGE指南。
在受影響版本上無法使用的替代方法
這些都在2026.8.1之前的版本上試過,在這些版本中掃描比其他所有事務先運行:
- 將首次IronPDF調用移出啟動:崩潰仍然會在首次使用按需端點時發生。
- 在
WEBSITE_RUN_FROM_ZIP和WEBSITE_RUN_FROM_PACKAGE之間切換: 都安裝為唯讀並以相同方式失敗。 - 使用遠程
IronPdfEngine:啟動掃描仍會先運行,因此在使用遠程連接之前就會失敗。 這是2026.8.1修復的具體行為。 - 將
Installation.TempFolderPath設置為可寫路徑:崩潰在設置被讀取之前發生。 從2026.8.1開始,設置會正常讀取。
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。