Chrome 渲染器在 Azure 應用服務 Linux 上冷啟動失敗

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 定期更新 App Service Linux 環境使用的基礎映像。這些更新可能會移除 Chrome 所需的共享庫，如 libnss3.so。當這種情況發生時，IronPDF 的 LinuxAndDockerDependenciesAutoConfig 機制會嘗試在啟動時重新安裝所需的包。如果服務超時時間短於完成此安裝所需的時間，則在 Chrome 準備好之前程式會被切斷。

在以下環境中已確認此問題：

影響的版本： IronPDF 2026.4.1
未受影響的版本： IronPDF 2026.5.2
託管： Azure App Service 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()

設置 LinuxAndDockerDependenciesAutoConfig 為 true 告訴 IronPDF 自動檢測和安裝缺少的 Linux 依賴項。設置 ChromeGpuMode 為 IronPdf.Engines.Chrome.ChromeGpuModes.Disabled 關閉 GPU 加速，這在 Azure 應用服務 Linux 環境中不可用。啟用完全日誌記錄有助於捕捉安裝依賴項過程中的任何錯誤。

接下來，將 Azure App Service 啟動超時至少增加到 10 分鐘。這樣可以給 IronPDF 足夠的時間在 Azure 基礎映像更新後於冷啟動時完成依賴項的重新安裝。請參閱 Azure 部署指南，以獲得在 App Service 配置中調整啟動時間限制設置的說明。