WEBSITE_RUN_FROM_PACKAGE設定時のIronPDF起動時のクラッシュ

Curtis Chau
Curtis Chau
更新日: 2026年8月31日

Azure App ServiceおよびAzure FunctionsにアプリがWEBSITE_RUN_FROM_PACKAGE = 1でデプロイされていると、IronPDFは起動時にクラッシュすることがあります。 この設定によりアプリのルート(C:\home\site\wwwroot)は読み取り専用のパッケージファイルシステムとしてマウントされ、IronPDFの起動時のファイルシステムスキャンが失敗し、通常、ライセンスキーの設定やリモートエンジンへの接続など最初のIronPDFコールでエラーが発生します。

System.IO.FileNotFoundException
Text

このスキャンはIronPDFが意図的に要求するものではありません。 これはNinjectのデフォルト拡張オートロードの副作用です。 C:\home\site\wwwroot が WEBSITE_RUN_FROM_PACKAGE = 1 では読み取り専用のため、スキャンがFileNotFoundExceptionをスローし、PDFの処理が始まる前に初期化が停止します。

これはIronPDF 2026.8.1で修正されています。 以前のバージョンが影響を受け、Windows(win-x64)の下の.NET 10では2026.7.0.2, 2025.12.2, 2025.3.6も含まれます。

解決策

どの手順が必要かは、リモートIronPdfEngineまたはネイティブIronPDFを使用するかによります。

リモートIronPdfEngineとIronPdf.Slim

IronPDF 2026.8.1以降にアップグレードしてください。 起動時スキャンはもう例外をスローしないので、WEBSITE_RUN_FROM_PACKAGE = 1を有効にしたままにでき、他の変更は不要です。 レンダリングはエンジン上で行われるため、ネイティブバイナリを読み取り専用のアプリルートに抽出する必要はありません。

エンジンモードでのIronPDFの使用を参照して接続設定を行ってください。

ネイティブIronPDF

アップグレードするだけでは十分ではありません。 起動時に、ネイティブIronPDFはChromeレンダラーバイナリとランタイムライブラリを書き込み可能な場所に抽出しますが、上記のスキャンバグとは独立して読み取り専用のC:\home\site\wwwrootがその抽出を阻止します。

Azure App Settingsで以下を設定し、再デプロイしてください:

WEBSITE_RUN_FROM_PACKAGE = 0
Text

Visual Studioからデプロイしていますか? 発行ステップでパッケージファイルから実行(推奨)のチェックを外してください。

パッケージファイルから実行(推奨)のチェックが外れたVisual Studio発行ダイアログ

  • デプロイパイプラインによっては、この設定をいくつかの異なる場所から適用できる場合があります。 どこで定義され、上書きされているかを追跡してください。
  • 変更を適用するには:再デプロイが必要です。 設定だけでは、アプリが再デプロイされるまで効果はありません。

書き込み可能パスの移動

ネイティブエンジンが読み取り専用のファイルシステムにChromiumおよびPDFiumのバイナリをデプロイできないとき、2026.8.1以降、デプロイメントエラーは原因と利用可能な処置を明示し、あいまいな下流の障害を回避します。 これらの対策の一つは、IronPDFの書き込み可能パスをパッケージマウントの外に指すことです:

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に精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 22,198,312バージョン:2026.11ちょうどリリースされました