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中已修复。 早期版本受到影响,包括在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
从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。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。