はじめに

IISを使っているプロジェクトで404エラーページを表示させるときにハマったことがあったので紹介します。

アプリケーション側でエラーページを実装したところローカルでは表示されるのに、
外部からアクセスすると**「404 ファイルまたはディレクトリが見つかりません。」**というページが表示されます。

実はこのエラーページへはIISの404カスタムエラーページで、
IISのApplicationHost.config/httpErrorsの設定が影響するようです。

httpErrorsとは

statusコード400以上のレスポンスの振る舞いを設定できるconfig項目です。
ApplicationHost.config/httpErrors配下の属性のうち、今回関連のあるerrorModeについて説明していきます。

HTTP エラーを有効にするかどうかを指定する。デフォルトはDetailedLocalOnly。

errorMode	説明
DetailedLocalOnly	アクセスがローカルPCからの場合は詳細エラーを返し、外部PCからの場合はカスタムエラーを返す。
Custom	サーバーが生成する詳細エラーをカスタムエラーで置き換えて返す。
Detailed	サーバーが生成する詳細エラーを返す。

※ApplicationHost.config/httpErrorsの設定はIISの構成エディターからできます。

詳細エラーというのはアプリケーション側で実装したエラーページ、カスタムエラーというのはIISのカスタムエラーページを指しています。

DetailedLocalOnlyはローカルアクセスのときはアプリケーション側で実装したエラーページを表示して、外部アクセスの時はIISのカスタムエラーページを表示します。
Customはローカル・外部アクセス問わずIISのカスタムエラーページを表示します。
Detailedはローカル・外部アクセス問わずアプリケーション側で実装したエラーページを表示します。

今回はerrorMode属性がデフォルトのままDetailedLocalOnlyだったことにより
IISのカスタムエラーページが表示されました。
なのでDetailedに設定することでIISのカスタムエラーページが表示されなくなりました。

※IISのカスタムエラーページを使用する場合はこちらから設定可能です。

IIS: 10.0