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中已修复。 早期版本受到影响,包括在Windows上(win-x64)运行的2026.7.0.2, 2025.12.2 和 2025.3.6,在.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设置中,进行以下设置然后重新部署:

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。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

NuGet 下载量 22,198,312版本:2026.11刚刚发布