HTTP Error 502.5 – ANCM Out‑Of‑Process Startup Failure の原因と対処法【ASP.NET Core・IIS対応】

「HTTP Error 502.5 – ANCM Out‑Of‑Process Startup Failure」が表示され、ASP.NET Core アプリケーションが IIS 上で起動できず困っていませんか？このエラーは、IIS の ASP.NET Core モジュールが、バックエンドの dotnet プロセスを正常に起動できなかった際に発生します。
ランタイムの不一致や構成ミスによって、アプリが起動できないリスクがあるため、対処には注意が必要です。

本記事では、主な原因と安全に確認できる対処法をわかりやすく解説しています。
業務アプリや公開サービスなど、失いたくないデータや設定が含まれる場合は、無理に操作せず、私たちデジタルデータリカバリーまでご相談ください。

相談から初期診断まで24時間365日体制で無料でご案内しています。

HTTP Error 502.5 – ANCM Out‑Of‑Process Startup Failureとは？症状と仕組み

このエラーは、ASP.NET Core アプリケーションが IIS 経由で起動される際、バックエンドの dotnet プロセスが開始に失敗することで発生します。
IIS は ASP.NET Core モジュール (ANCM) を使ってアプリを起動しますが、dotnet ランタイムの不整合や設定ミスなどがあると、プロセスが即座に終了して 502.5 エラーが返されます。

アプリケーションの実行環境に問題があることを示す初期化失敗エラーであり、開発・本番を問わず注意すべきエラーです。

HTTP Error 502.5 の主な症状

HTTP Error 502.5 の原因

このエラーは、アプリの実行に必要なランタイムがサーバーに存在しない、またはアプリ構成が誤っていることで発生します。以下に代表的な原因を整理しました。

.NET Coreランタイムの未インストールやバージョン不一致

最もよくある原因です。dotnetコマンドで使用されるランタイムがサーバーに存在しない、もしくはアプリが要求するバージョンと合っていない場合、プロセスが起動できず502.5エラーになります。

web.configやアプリ設定ファイルのミス

web.configに記載されたprocessPathの誤記や、stdoutLogEnabledの記述ミス、またはappsettings.jsonの構文エラーなども、dotnetプロセスの初期化失敗を引き起こす要因です。

依存DLLやファイルの配置漏れ

アプリに必要なDLLやリソースファイルがビルド時またはデプロイ時に含まれていないと、アプリは起動直後に異常終了し502.5エラーになります。

実行権限やパーミッション設定の問題

IISアプリプールのアクセス権や、アプリがログ出力やファイルアクセスに必要とするフォルダへの書き込み権限が不足している場合、起動失敗の原因となります。

重大な構成不備・アプリ破損による即時終了

プロジェクト構成ファイルの破損、ターゲットフレームワーク指定ミス、DLLの不整合など、アプリの内部構成に問題があると、dotnetプロセスが即時終了し、アプリのデータやログが出力されないままクラッシュするリスクがあります。

この状態で無理な再デプロイを行うと、データ消失やログ破損の可能性があるため注意が必要です。重要なアプリケーションで問題が発生している場合は、無理に再構成せず、まずは当社までご相談ください。相談から初期診断まで24時間365日無料で対応しています。

【要注意】自力対応が招くデータ損失のリスク

「突然エラーメッセージが表示された」――そんなトラブルに直面したとき、まずは自力で何とかしようと対応する方が多いと思います。

突然エラーメッセージが出てきた場合、内部に深刻なトラブルが発生している可能性があり、初期化や分解などを自己判断で行うと、かえって状態を悪化させてしまうことがあります。今はアクセスできなくても、必要なデータが残っている可能性があるため、誤った操作をする前に専門業者への相談が求められます。

専門業者であれば、正確な診断に基づいて最適な方法で復旧を進めるため、データ消失を最低限に抑えることができます。中でもデジタルデータリカバリーは、以下の理由から多くの方に選ばれています。

• 相談実績46万件以上（2011年1月～）の豊富な対応経験に基づき、個人・法人問わず幅広いトラブルに対応
• 一部復旧を含む復旧件数割合91.5%（※内、完全復旧57.8%。復旧件数割合＝データ復旧件数／データ復旧ご依頼件数。2023年10月実績）という業界トップクラスの技術力
• 他社で「復旧不可」とされた機器の対応実績が7,300件越えにものぼり、独自の復旧技術を保有

大切なデータを守るには、まずは自力対応よりも専門的な判断が欠かせません。操作を誤る前に、まずは当社にご相談ください。

 

HTTP Error 502.5 の対処法

ここでは、502.5エラーが出た際に行うべき対処法をステップごとに解説します。サーバー構成に不安がある場合は、無理に設定変更を行わず、バックアップを取ったうえで作業することを推奨します。

dotnetランタイムの確認と再インストール

コマンドプロンプトで `dotnet –list-runtimes` を実行し、必要なランタイムがサーバーにインストールされているか確認します。不足している場合は Microsoft 公式サイトから対象バージョンをインストールします。

web.configのログ出力を有効にしてエラー内容確認

web.configの`stdoutLogEnabled`をtrueに設定し、出力先を確認してエラーログを取得します。ログが出力されれば、起動失敗の詳細原因を把握できます。

依存DLLやリソースの再ビルドと配置確認

dotnet publish コマンドでアプリを再ビルド・再出力し、すべての必要ファイルがサーバー上に正しく配置されているか確認します。

アプリのパーミッション設定を見直す

アプリがアクセスするログフォルダやconfigファイルなどに対して、IISアプリプールのユーザーに適切な読み書き権限があるかを確認します。

専門業者に相談する

上記をすべて試しても解決しない場合や、業務サービスで早急な復旧が求められる場合は、無理に自己対応を続けず、早めに専門業者へご相談ください。
私たちデジタルデータリカバリーは、これまでに46万件以上の相談実績（※1）を持ち、一部復旧を含む復旧件数割合91.5%（※2）という高い成果を上げています。初期相談・診断は無料で、24時間365日対応しています。お気軽にご相談ください。

※1　期間：2011年1月以降
※2　内、完全復旧57.8%。復旧件数割合＝データ復旧件数/データ復旧ご依頼件数。2023年10月実績