* Aktualisiert im April 2016
Das customErrors-Attribut wird verwendet, wenn der .net-Code eine Ausnahme auslöst (404, 403, 500 usw.), und das httpErrors-Attribut wird verwendet, wenn IIS selbst eine Ausnahme auslöst.
- / myfakeextensionslessurl -> httpErrors 404
- /myfakeaspsx.aspx -> customErrors 404
- /myfakeimage.jpg -> httpErrors 404
- /throw500.apx -> customErrors 500
- / throw500 -> customErrors 500
Es gibt viele Fallstricke, die versuchen, dies richtig zu konfigurieren. Wenn Sie also nach einem kurzen Beispiel suchen, sind die besten 2 Optionen, die Sie haben:
Beispiel 1: Verwenden von HTML-Seiten
<system.web>
<customErrors mode="RemoteOnly" defaultRedirect="/Error500.html" redirectMode="ResponseRewrite">
<error statusCode="403" redirect="/Error403.html" />
<error statusCode="404" redirect="/Error404.html" />
<error statusCode="500" redirect="/Error500.html" />
</customErrors>
</system.web>
<system.webServer>
<httpErrors errorMode="DetailedLocalOnly" existingResponse="Auto">
<remove statusCode="403" />
<remove statusCode="404" />
<remove statusCode="500" />
<error statusCode="403" responseMode="File" path="Error403.html" />
<error statusCode="404" responseMode="File" path="Error404.html" />
<error statusCode="500" responseMode="File" path="Error500.html" />
</httpErrors>
</system.webServer>
Beispiel 2: Verwenden von Aspx-Seiten
<system.web>
<customErrors mode="RemoteOnly" defaultRedirect="/Error500.html" redirectMode="ResponseRewrite">
<error statusCode="403" redirect="/Error403.aspx" />
<error statusCode="404" redirect="/Error404.aspx" />
<error statusCode="500" redirect="/Error500.aspx" />
</customErrors>
</system.web>
<system.webServer>
<httpErrors errorMode="DetailedLocalOnly" existingResponse="Auto">
<remove statusCode="403" />
<remove statusCode="404" />
<remove statusCode="500" />
<error statusCode="403" responseMode="ExecuteURL" path="Error403.aspx" />
<error statusCode="404" responseMode="ExecuteURL" path="Error404.aspx" />
<error statusCode="500" responseMode="ExecuteURL" path="Error500.aspx" />
</httpErrors>
</system.webServer>
Und auf den Aspx-Fehlerseiten müssen Sie Folgendes tun (Beispiel 404-Seite):
<%
Response.StatusCode = 404;
Response.TrySkipIisCustomErrors = true;
%>
Hinweis: Die Verwendung von URLs ohne Erweiterung im Abschnitt customErrors ist nicht möglich! . (ohne Hacks)
Eine Problemumgehung besteht darin, benutzerdefinierte Fehler zu deaktivieren und http-Fehler die benutzerdefinierte Seite behandeln zu lassen. Ein Freund hat ein solches Setup erstellt. Wenn ich etwas Zeit finde, werde ich den Code freigeben.
Hintergrund
Eine gute benutzerdefinierte Fehlerseite wird:
- Zeigen Sie die echte Ausnahme an, wenn Sie die Problemseite lokal besuchen
- Zeigen Sie eine benutzerdefinierte Seite an, wenn Sie die Problemseite remote besuchen
- Leitet nicht weiter, sondern zeigt einfach den Inhalt der Fehlerseite an (aus SEO-Gründen)
- Zeigt den richtigen Statuscode an
Um einige Optionen in unserer Konfiguration zu verdeutlichen:
<customErrors mode="RemoteOnly". Sie können hier angeben: On, Off, RemoteOnly.
On = Benutzerdefinierte Fehlerseiten immer anzeigenOff = Zeige immer den wirklichen FehlerRemoteOnly= Zeigen Sie den Fehler lokal an, aber zeigen Sie die benutzerdefinierte Fehlerseite remote an. Also wollen wir RemoteOnlyfür Aussage 1
<customErrors redirectMode="ResponseRewrite". Hier können Sie angeben: ResponseRedirectoder ResponseRewrite. Der ResponseRedirectModus leitet die Fehlerseite zur benutzerdefinierten Fehlerseite um. Für einen Linkcrawler (SEO) führt dies zu 302 -> 500, aber Sie möchten, dass der Linkcrawler einen Fehler von 500 erhält.
<httpErrors errorMode="DetailedLocalOnly". Dies entspricht dem customErrorsModus. Optionen , die Sie haben: Custom, Detailed, DetailedLocalOnly.
Ein guter Blog-Beitrag, der mir sehr geholfen hat, ist: http://benfoster.io/blog/aspnet-mvc-custom-error-pages