在Azure应用服务Linux上的冷启动中Chrome渲染器失败

Updated: 2026年6月10日

当Azure更新底层Oryx/Ubuntu基础镜像时，会移除IronPDF的Chrome渲染器所依赖的共享库，这一问题会在Azure应用服务Linux上出现。在下一次冷启动时，IronPDF必须从头重新安装这些原生的Chrome依赖，这一过程可能需要长达5分钟。如果应用程序启动超时设置过短，安装会被中断，渲染器将无法运行。

错误通常显示为：

libnss3.so: cannot open shared object file: No such file or directory

libnss3.so: cannot open shared object file: No such file or directory

Text

Azure会定期更新应用服务Linux环境所使用的基础镜像。这些更新可以删除Chrome所需的共享库，例如libnss3.so。当这种情况发生时，IronPDF的LinuxAndDockerDependenciesAutoConfig机制会尝试在启动时重新安装所需的软件包。如果服务超时时间短于完成此安装所需的时间，进程将在Chrome准备好之前被中断。

在以下环境中已确认此问题：

**受影响的版本：**IronPDF 2026.4.1
**未受影响的版本：**IronPDF 2026.5.2
**托管：**Azure应用服务P0v3计划，挪威东部区域
运行时：.NET 10

解决方案

解决方案1：应用初始化设置并增加启动超时时间

在任何PDF渲染调用之前，在应用启动时添加以下初始化代码：

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Option Strict On
Option Infer On

Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()

Option Strict On
Option Infer On

Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()

将true告知IronPDF自动检测并安装缺失的Linux依赖项。将IronPdf.Engines.Chrome.ChromeGpuModes.Disabled关闭GPU加速，因为在Azure App Service Linux环境中不可用。启用完整日志记录有助于捕获在依赖项安装步骤中产生的任何错误。

接下来，将Azure应用服务的启动超时增加至至少10分钟。这给IronPDF足够的时间在Azure基础镜像更新后的冷启动期间完成依赖项重新安装。请参阅Azure部署指南以获取有关在应用服务配置中调整启动时间限制设置的说明。