ASP.NET Core を使用した Azure App Service および IIS の一般的なエラーのトラブルシューティング

このトピックでは、最も一般的なエラーについて説明し、Azure Apps Service と IIS で ASP.NET Core アプリをホストする場合のトラブルシューティングのアドバイスを提供します。

一般的なアプリ起動時のエラーとエラーを診断する方法については、「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」の情報を参照してください。

次の情報を収集します。

• ブラウザーの動作 (状態コードやエラー メッセージなど)。
• アプリケーション イベント ログのエントリ
  • Azure App Service: 「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。
  • IIS
    1. [Windows] メニューで [スタート] を選択し、「Event Viewer」と入力し、Enter を押します。
    2. イベント ビューアーが開いたら、サイドバーで [Windows ログ]、[アプリケーション] の順に展開します。
• ASP.NET Core モジュールの stdout ログ エントリと debug ログ エントリ
  • Azure App Service: 「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。
  • IIS:ASP.NET Core モジュール トピックの「ログの作成とリダイレクト」と「強化された診断ログ」のセクションの指示に従います。

エラー情報を次の一般的なエラーと比較します。 一致が見つかった場合は、トラブルシューティングのアドバイスに従います。

このトピックではすべてのエラーを網羅しているわけではありません。 ここに記載されていないエラーに遭遇した場合、このトピックの一番下にある [コンテンツ フィードバック] ボタンで新しい問題を登録してください。その際、エラーを再現する方法を詳しく教えてください。

重要

Azure App Service と ASP.NET Core のプレビュー リリース

ASP.NET Core のプレビュー リリースは、既定では Azure App Service に展開されません。 ASP.NET Core プレビュー リリースを使用するアプリをホストするには、「Azure App Service に ASP.NET Core プレビュー リリースを展開する」を参照してください。

OS のアップグレードによって 32 ビット ASP.NET Core モジュールが削除された

アプリケーション ログ: モジュール DLL C:\WINDOWS\system32\inetsrv\aspnetcore.dll を読み込めませんでした。 このデータはエラーです。

トラブルシューティング:

C:\Windows\SysWOW64\inetsrv ディレクトリにある OS ファイルでないファイルは、OS アップグレード時に保持されません。 OS アップグレードより前に ASP.NET Core モジュールをインストールしていた場合、OS アップグレード後に 32 ビット モードでアプリ プールを実行しようとすると、この問題が発生します。 OS アップグレード後に ASP.NET Core モジュールを修復してください。 「.NET Core ホスティング バンドルのインストール」をご覧ください。 インストーラーを実行するときに [修復] を選択します。

サイト拡張機能の不足、32 ビット (x86) および 64 ビット (x64) サイト拡張機能がインストールされている、または間違ったプロセス ビットが設定されている

"Azure App Services でホストしているアプリに適用されます。 "

• ブラウザー: HTTP エラー 500.0 - ANCM インプロセス ハンドラーの読み込みエラー

• アプリケーション ログ: hostfxr を呼び出し、インプロセス要求ハンドラーを見つけようとすると、ネイティブの依存関係が見つからず、失敗しました。 インプロセス要求ハンドラーが見つかりませんでした。 hostfxr の呼び出し時にキャプチャされた出力:互換性のあるフレームワーク バージョンが見つかりませんでした。 指定したフレームワーク 'Microsoft.AspNetCore.App'、バージョン '{VERSION}-preview-*' が見つかりませんでした。 アプリケーション '/LM/W3SVC/1416782824/ROOT' を起動できませんでした、エラー コード '0x8000ffff'。

• ASP.NET Core モジュールの stdout ログ: 互換性のあるフレームワーク バージョンが見つかりませんでした。 指定したフレームワーク 'Microsoft.AspNetCore.App'、バージョン '{VERSION}-preview-*' が見つかりませんでした。

• ASP.NET Core モジュール デバッグ ログ: hostfxr を呼び出し、インプロセス要求ハンドラーを見つけようとすると、ネイティブの依存関係が見つからず、失敗しました。 これが意味するところは、ほとんどの場合、アプリが正しく設定されていないということです。アプリケーションの対象であり、コンピューターにインストールされている Microsoft.NetCore.App と Microsoft.AspNetCore.App のバージョンを確認してください。 HRESULT が失敗し、次が返されました:0x8000ffff。 インプロセス要求ハンドラーが見つかりませんでした。 互換性のあるフレームワーク バージョンが見つかりませんでした。 指定したフレームワーク 'Microsoft.AspNetCore.App'、バージョン '{VERSION}-preview-*' が見つかりませんでした。

トラブルシューティング:

• プレビュー ランタイムでアプリを実行している場合、アプリのビットとアプリのランタイム バージョンに一致する、32 ビット (x86) または 64 ビット (x64) のいずれかのサイト拡張機能をインストールします。 両方の拡張機能や、拡張機能の複数のランタイム バージョンをインストールしないでください。

  • ASP.NET Core {ランタイム バージョン} (x86) ランタイム
  • ASP.NET Core {ランタイム バージョン} (x64) ランタイム

  アプリを再起動します。 アプリが再起動するまで数秒待ちます。

• プレビュー ランタイムでアプリを実行していて、32 ビット (x86)、64 ビット (x64) 両方のサイト拡張機能がインストールされている場合、アプリのビットと一致しないサイト拡張機能をアンインストールします。 サイト拡張機能を削除した後、アプリを再起動します。 アプリが再起動するまで数秒待ちます。

• プレビュー ランタイムでアプリを実行していて、サイト拡張機能とアプリのビットが一致している場合、プレビュー サイト拡張機能の "ランタイム バージョン" がアプリのランタイム バージョンと一致していることを確認します。

• [アプリケーション設定] のアプリの [プラットフォーム] がアプリのビットと一致していることを確認します。

詳細については、「Azure App Service に ASP.NET Core アプリを展開する」を参照してください。

x86 アプリが展開されますが、32 ビット アプリに対してアプリ プールは有効になりません。

• ブラウザー: HTTP エラー 500.30 - ANCM インプロセス起動失敗

• アプリケーション ログ: 物理ルートが '{PATH}' のアプリケーション '/LM/W3SVC/5/ROOT' に予想外のマネージド例外が発生しました、例外コード = '0xe0434352'。 詳細については、stderr ログを確認してください。 物理ルートが '{PATH}' のアプリケーション '/LM/W3SVC/5/ROOT' で clr とマネージド アプリケーションを読み込めませんでした。 CLR ワーカー スレッドが途中で終了しました

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されましたが、空です。

• ASP.NET Core モジュール デバッグ ログ: HRESULT が失敗し、次が返されました:0x8007023e

このシナリオは、自己完結型アプリの公開時、SDK によってトラップされます。 RID がプラットフォーム ターゲットに一致しない場合 (win10-x64 RID とプロジェクト ファイルの <PlatformTarget>x86</PlatformTarget> など)、SDK からエラーが生成されます。

トラブルシューティング:

x86 フレームワークに依存する展開の場合 (<PlatformTarget>x86</PlatformTarget>)、32 ビット アプリに対して IIS アプリ プールを有効にします。 IIS Manager でアプリ プールの [詳細設定] を開き、 [32 ビット アプリケーションの有効化] を [True] に設定します。

プラットフォームが RID と競合している

• ブラウザー: HTTP エラー 502.5 - 処理エラー

• アプリケーション ログ: 物理ルートが 'C:{PATH}' のアプリケーション 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' は、コマンドライン '"C:{PATH}{ASSEMBLY}.{exe|dll}" ' でプロセスを開始できませんでした。ErrorCode = '0x80004005 : ff。

• ASP.NET Core モジュールの stdout ログ: 未処理の例外:System.BadImageFormatException:ファイルまたはアセンブリ '{ASSEMBLY}.dll' を読み込めませんでした。 正しくない形式のプログラムを読み込もうとしました。

トラブルシューティング:

• Kestrel でアプリをローカルに実行できることを確認します。 プロセスのエラーは、アプリ内の問題の結果である可能性があります。 詳細については、「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。

• Azure Apps 展開で、アプリケーションをアップグレードして新しいアセンブリを展開しようとしたときにこの例外が発生した場合は、以前の展開からすべてのファイルを手動で削除してください。 アップグレードしたアプリを展開するとき、互換性のないアセンブリが残っていると、System.BadImageFormatException 例外が発生します。

URI のエンドポイントが間違っているか、Web サイトが停止している

• ブラウザー: ERR_CONNECTION_REFUSED --または-- 接続できません

• アプリケーション ログ: エントリなし

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: ログ ファイルが作成されていません。

トラブルシューティング:

• アプリに対して正しい URI エンドポイントが使用されていることを確認します。 バインドを確認します。

• IIS Web サイトが [停止] 状態でないことを確認します。

CoreWebEngine または W3SVC サーバー機能が無効

OS の例外: ASP.NET Core モジュールを使用するには、IIS 7.0 CoreWebEngine および W3SVC の機能をインストールする必要があります。

トラブルシューティング:

適切な役割と機能が有効になっていることを確認します。 「IIS 構成」を参照してください。

Web サイト物理パスが間違っているか、アプリが見つからない

• ブラウザー: 403 許可されていません - アクセスが拒否されました --または-- 403.14 許可されていません - Web サーバーは、このディレクトリの内容の一覧を表示しないように構成されています。

• アプリケーション ログ: エントリなし

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: ログ ファイルが作成されていません。

トラブルシューティング:

IIS Web サイトの基本設定と物理アプリのフォルダーを確認します。 アプリが IIS Web サイトの物理パスにあるフォルダー内に配置されていることを確認します。

役割が正しくない、ASP.NET Core モジュールがインストールされていない、または不適切なアクセス許可

• ブラウザー: 500.19 内部サーバー エラー - ページに関連する構成データが無効であるため、要求されたページにアクセスできません。 --または-- このページを表示できません

• アプリケーション ログ: エントリなし

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: ログ ファイルが作成されていません。

トラブルシューティング:

• 適切な役割が有効になっていることを確認します。 「IIS 構成」を参照してください。

• [プログラムと機能] または [アプリと機能] を開き、[Windows Server Hosting] がインストールされていることを確認します。 インストールされているプログラムの一覧に [Windows Server Hosting] がない場合、.NET Core ホスティング バンドルをダウンロードしてインストールします。

  現在の .NET Core ホスティング バンドルのインストーラー (直接ダウンロード)

  詳細については、「.NET Core ホスティング バンドルのインストール」をご覧ください。

• [アプリケーション プール]>[プロセス モデル]>Identity が ApplicationPoolIdentity に設定されていることを確認します。または、カスタム identity にアプリの展開フォルダーにアクセスするための正しいアクセス許可があることを確認します。

• ASP.NET Core ホスティング バンドルをアンインストールし、以前のバージョンのホスティング バンドルをインストールした場合、applicationHost.config ファイルには ASP.NET Core モジュールのセクションが含まれません。 applicationHost.config で %windir%/System32/inetsrv/config を開き、<configuration><configSections><sectionGroup name="system.webServer"> セクション グループを見つけます。 セクション グループに ASP.NET Core モジュールのセクションがない場合は、セクション要素を追加します。

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  または、ASP.NET Core ホスティング バンドルの最新バージョンをインストールします。 最新バージョンは、ポートされている ASP.NET Core アプリと下位互換性があります。

processPath の誤り、PATH 変数の欠如、ホスティング バンドルが未インストール、システムまたは IIS が再起動されていない、VC++ 再頒布可能パッケージが未インストール、dotnet.exe アクセス違反

• ブラウザー: HTTP エラー 500.0 - ANCM インプロセス ハンドラーの読み込みエラー

• アプリケーション ログ: 物理ルートが 'C:{PATH}' のアプリケーション 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' は、コマンドライン '"{...}" ' でプロセスを開始できませんでした。ErrorCode = '0x80070002 : 0。 アプリケーション '{PATH}' は開始できませんでした。 実行可能ファイルが '{PATH}' で見つかりませんでした。 アプリケーション '/LM/W3SVC/2/ROOT' を起動できませんでした、エラー コード '0x8007023e'。

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: イベント ログ:'アプリケーション '{PATH}' を起動できませんでした。 実行可能ファイルが '{PATH}' で見つかりませんでした。 HRESULT が失敗し、次が返されました:0x8007023e

トラブルシューティング:

• Kestrel でアプリをローカルに実行できることを確認します。 プロセスのエラーは、アプリ内の問題の結果である可能性があります。 詳細については、「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。

• web.config で <aspNetCore> 要素の processPath 属性を調べ、フレームワークに依存する展開 (FDD) の場合はそれが dotnet であること、自己完結型展開 (SCD) の場合はそれが .\{ASSEMBLY}.exe であることを確認します。

• FDD の場合、PATH 設定で dotnet.exe にアクセスできていない可能性があります。 C:\Program Files\dotnet がシステムの PATH 設定に含まれていることを確認します。

• FDD では、アプリ プールのユーザー identity で dotnet.exe にアクセスできていない可能性があります。 アプリ プール ユーザー identity に、C:\Program Files\dotnet ディレクトリへのアクセス許可が設定されていることを確認します。 C:\Program Files\dotnet とアプリのディレクトリに、アプリ プール ユーザー identity に対する拒否ルールが構成されていないことを確認します。

• FDD を配置し、IIS を再起動せずに .NET Core をインストールした可能性があります。 サーバーを再起動するか、コマンド プロンプトから net stop was /y に続けて net start w3svc を実行して IIS を再起動します。

• ホスト システムで、 .NET Core ランタイムをインストールせずに、FDD を配置した可能性があります。 .NET Core ランタイムがインストールされていない場合は、システムで .NET Core ホスティング バンドルのインストーラーを実行します。

  現在の .NET Core ホスティング バンドルのインストーラー (直接ダウンロード)

  詳細については、「.NET Core ホスティング バンドルのインストール」をご覧ください。

  特定のランタイムが必要な場合、.NET ダウンロードのページからランタイムをダウンロードし、システムにインストールしてください。 インストールを完了するために、システムを再起動するか、コマンド プロンプトから net stop was /y に続けて net start w3svc を実行して IIS を再起動します。

<aspNetCore> 要素の引数の誤り

• ブラウザー: HTTP エラー 500.0 - ANCM インプロセス ハンドラーの読み込みエラー

• アプリケーション ログ: hostfxr を呼び出し、インプロセス要求ハンドラーを見つけようとすると、ネイティブの依存関係が見つからず、失敗しました。 これが意味するところは、ほとんどの場合、アプリが正しく設定されていないということです。アプリケーションの対象であり、コンピューターにインストールされている Microsoft.NetCore.App と Microsoft.AspNetCore.App のバージョンを確認してください。 インプロセス要求ハンドラーが見つかりませんでした。 hostfxr の呼び出し時にキャプチャされた出力:dotnet SDK コマンドを実行しますか? dotnet SDK を https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 からインストールしてください。アプリケーション '/LM/W3SVC/3/ROOT' を起動できませんでした。ErrorCode '0x8000ffff'。

• ASP.NET Core モジュールの stdout ログ: dotnet SDK コマンドを実行しますか? dotnet SDK を https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 からインストールしてください

• ASP.NET Core モジュール デバッグ ログ: hostfxr を呼び出し、インプロセス要求ハンドラーを見つけようとすると、ネイティブの依存関係が見つからず、失敗しました。 これが意味するところは、ほとんどの場合、アプリが正しく設定されていないということです。アプリケーションの対象であり、コンピューターにインストールされている Microsoft.NetCore.App と Microsoft.AspNetCore.App のバージョンを確認してください。 HRESULT が失敗し、次が返されました:0x8000ffff インプロセス要求ハンドラーが見つかりませんでした。 hostfxr の呼び出し時にキャプチャされた出力:dotnet SDK コマンドを実行しますか? dotnet SDK を https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 からインストールしてください。HRESULT が失敗し、次が返されました: 0x8000ffff

トラブルシューティング:

• Kestrel でアプリをローカルに実行できることを確認します。 プロセスのエラーは、アプリ内の問題の結果である可能性があります。 詳細については、「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。

• web.config で <aspNetCore> 要素の arguments 属性を調べ、次のいずれかになっていることを確認します。(a) フレームワークに依存する展開 (FDD) の場合は .\{ASSEMBLY}.dll、または (b) 自己完結型の展開 (SCD) の場合は、未指定の空の文字列 (arguments="") か、アプリの引数のリスト (arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}")。

.NET Core 共有フレームワークがありません

• ブラウザー: HTTP エラー 500.0 - ANCM インプロセス ハンドラーの読み込みエラー

• アプリケーション ログ: hostfxr を呼び出し、インプロセス要求ハンドラーを見つけようとすると、ネイティブの依存関係が見つからず、失敗しました。 これが意味するところは、ほとんどの場合、アプリが正しく設定されていないということです。アプリケーションの対象であり、コンピューターにインストールされている Microsoft.NetCore.App と Microsoft.AspNetCore.App のバージョンを確認してください。 インプロセス要求ハンドラーが見つかりませんでした。 hostfxr の呼び出し時にキャプチャされた出力:互換性のあるフレームワーク バージョンが見つかりませんでした。 指定のフレームワーク 'Microsoft.AspNetCore.App', version '{VERSION}' が見つかりませんでした。

アプリケーション '/LM/W3SVC/5/ROOT' を起動できませんでした、エラー コード '0x8000ffff'。

• ASP.NET Core モジュールの stdout ログ: 互換性のあるフレームワーク バージョンが見つかりませんでした。 指定のフレームワーク 'Microsoft.AspNetCore.App', version '{VERSION}' が見つかりませんでした。

• ASP.NET Core モジュール デバッグ ログ: HRESULT が失敗し、次が返されました:0x8000ffff

トラブルシューティング:

フレームワークに依存する展開 (FDD) では、正しいランタイムがシステムにインストールされていることを確認します。

アプリケーション プールの停止

• ブラウザー: 503 サービスをご利用いただけません

• アプリケーション ログ: エントリなし

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: ログ ファイルが作成されていません。

トラブルシューティング:

アプリケーション プールが [停止] 状態でないことを確認します。

サブアプリケーションに <handlers> セクションが含まれている

• ブラウザー: HTTP エラー 500.19 - 内部サーバー エラー

• アプリケーション ログ: エントリなし

• ASP.NET Core モジュールの stdout ログ: ルート アプリのログ ファイルが作成され、通常の操作を示しています。 サブアプリのログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: ルート アプリのログ ファイルが作成され、通常の動作を示します。 サブアプリのログ ファイルが作成されません。

トラブルシューティング:

サブアプリの web.config ファイルに <handlers> セクションがないか、サブアプリが親アプリのハンドラーを継承していないことを確認してください。

<system.webServer> の親アプリの <system.webServer> セクションが <location> 要素の中に置かれています。 InheritInChildApplications プロパティは、false に設定されます。これは、InheritInChildApplications 要素内で指定された設定が、親アプリのサブディレクトリにあるアプリによって継承されないことを示します。 詳細については、「IIS の ASP.NET Core モジュール (ANCM)」を参照してください。

stdout ログのパスが正しくありません

• ブラウザー: アプリは通常どおりに応答します。

• アプリケーション ログ: C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll で stdout リダイレクトを開始できません。 例外メッセージ:HRESULT 0x80070005 が {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 で返されました。 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll で stdout リダイレクトを停止できません。 例外メッセージ:HRESULT 0x80070002 が {PATH} で返されました。 {PATH}\aspnetcorev2_inprocess.dll で stdout リダイレクトを開始できません。

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されていません。

• ASP.NET Core モジュール デバッグ ログ: C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll で stdout リダイレクトを開始できません。 例外メッセージ:HRESULT 0x80070005 が {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 で返されました。 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll で stdout リダイレクトを停止できません。 例外メッセージ:HRESULT 0x80070002 が {PATH} で返されました。 {PATH}\aspnetcorev2_inprocess.dll で stdout リダイレクトを開始できません。

トラブルシューティング:

• stdoutLogFile の <aspNetCore> 要素で指定された stdoutLogFile パスが存在しません。 詳細については、「ASP.NET Core モジュール:ログの作成とリダイレクト」を参照してください。

• アプリ プール ユーザーに stdout ログ パスに対する書き込みアクセス権がありません。

アプリケーション構成の一般的な問題

• ブラウザー: HTTP エラー 500.0 - ANCM インプロセス要求ハンドラー失敗 --または-- HTTP エラー 500.30 - ANCM インプロセス起動失敗

• アプリケーション ログ: 変数

• ASP.NET Core モジュールの stdout ログ: ログ ファイルが作成されますが空です。あるいは作成され、通常のエントリが含まれますが、アプリのところでエラーが発生します。

• ASP.NET Core モジュール デバッグ ログ: 変数

トラブルシューティング:

このプロセスはおそらく、アプリの設定またはプログラミングに問題があり、開始できませんでした。

詳細については、次のトピックを参照してください。

• Azure App Service および IIS での ASP.NET Core のトラブルシューティング
• ASP.NET Core プロジェクトのトラブルシューティングとデバッグ