ChromeレンダラーがAzure App Service Linuxでの初回起動時に失敗する
この問題は、AzureによるOryx/Ubuntuベースイメージの更新によって、IronPDFのChromeレンダラーが依存する共有ライブラリが削除された場合にAzure App Service Linuxで発生します。 次の初回起動時に、IronPDFはこれらのネイティブChromeの依存関係をゼロから再インストールする必要があり、このプロセスは最大5分かかる可能性があります。 アプリケーションの起動タイムアウトが短すぎる場合、インストールが中断され、レンダラーが失敗します。
エラーは通常次のように表示されます:
libnss3.so: cannot open shared object file: No such file or directoryAzureは定期的に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();Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()IronPDFに、Linuxの依存関係の欠如を自動的に検出しインストールするようにするには、trueに設定します。 GPUアクセラレーションはAzure App Service Linux環境で利用できないため、IronPdf.Engines.Chrome.ChromeGpuModes.Disabledに設定して無効にします。 完全なログを有効にすると、依存関係のインストールステップでのエラーをキャッチしやすくなります。
次に、Azure App Serviceの起動タイムアウトを少なくとも10分に延長します。 これにより、Azureのベースイメージ更新後の初回起動時に依存関係の再インストールを完了するのにIronPDFに十分な時間が与えられます。 App Serviceの設定で起動時間制限を調整する手順については、Azureデプロイメントガイドをご覧ください。
ソリューション2: IronPDF 2026.5.2以降にアップグレードする
IronPDF 2026.5.2またはそれ以降のバージョンにアップグレードするとこの問題が解決します。 影響を受けないバージョンは、Azureベースイメージの更新が共有ライブラリを削除しても初回起動の失敗を引き起こさないように対応しています。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。
