IronPDF在使用WEBSITE_RUN_FROM_PACKAGE時啟動崩潰

Curtis Chau
Curtis Chau
已更新: 2026年8月31日

當應用程式是用WEBSITE_RUN_FROM_PACKAGE = 1部署在Azure App Service和Azure Functions時,IronPDF可能會在啟動時崩潰。 該設置將應用程式根目錄(C:\home\site\wwwroot)掛載為只讀的包文件系統,IronPDF的啟動文件系統掃描在該系統上會失敗,通常在第一次IronPDF調用(如設置授權金鑰或連接到遠程引擎)時發生。

System.IO.FileNotFoundException
Text

該掃描並非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
Text

從Visual Studio部署嗎? 在發佈步驟中,取消勾選從包文件運行(建議)。

Visual Studio發佈對話框,未勾選從包文件運行(建議)的選項

  • 根據您的部署管道,這個設置可以從幾個不同地方應用。 追蹤它是在哪裡定義的,以及可能被覆蓋的地方。
  • 要應用更改:您必須重新部署。 僅有該設置不會有所影響,直到應用重新部署。

重定位可寫的路徑

從2026.8.1開始,當本地引擎無法在只讀文件系統上部署其Chromium和PDFium二進制文件時,部署錯誤會命名原因和可用的修復方法,而不是讓不清楚的下游失敗浮現。 這些修復方法之一是將IronPDF的可寫路徑指向包掛載外的某處:

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 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布