ChromeレンダラーがAzure App Service Linuxでの初回起動時に失敗する

更新日:2026年6月9日

Translated

View the article in English

この問題は、AzureによるOryx/Ubuntuベースイメージの更新によって、IronPDFのChromeレンダラーが依存する共有ライブラリが削除された場合にAzure App Service Linuxで発生します。次の初回起動時に、IronPDFはこれらのネイティブChromeの依存関係をゼロから再インストールする必要があり、このプロセスは最大5分かかる可能性があります。アプリケーションの起動タイムアウトが短すぎる場合、インストールが中断され、レンダラーが失敗します。

エラーは通常次のように表示されます:

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

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



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

$vbLabelText $csharpLabel

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ベースイメージの更新が共有ライブラリを削除しても初回起動の失敗を引き起こさないように対応しています。

重要この問題はIronPDF 2026.5.2で解決されました。このバージョン以降を使用している場合、ソリューション1の回避策は不要です。

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 20,088,359 | バージョン: 2026.7 リリースされたばかり