ASP.NET MVC自定義錯誤頁面真的簡單嗎?
如果你在設置asp.net mvc自定義錯誤頁面時遇到問題，這并不止你一個人。驚訝之余你的做法是正確的，沒有起到作用的原因是其一部分錯誤是由asp.net管道處理的，另一部分是由iis直接處理。
通常情況 （我期望是這種情況，在一些其他框架/服務器上） 我們只需要在一個地方配置自定義錯誤頁就可以了，無論怎么哪兒引發(fā)的錯誤。就像這樣︰
<customErrors mode="On"> <error code="404" path="404.html" /> <error code="500" path="500.html" /> </customErrors>
自定義404錯誤頁面
當一個資源不存在時（包含靜態(tài)和動態(tài)），我們需要返回一個404狀態(tài)的頁面，通常我們需要提供一些稍微友好的信息替代asp.net/iis生成的默認錯誤頁呈現(xiàn)給我們的網(wǎng)站訪問者，可能是提出一些忠告 為什么該資源可能不存在或提供選擇要搜索的網(wǎng)站。
這里僅作演示簡單設置如下：
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"/> <title>404 Page Not Found</title> </head> <body> <h1>404 Page Not Found</h1> </body> </html>
我創(chuàng)建了一個新的ASP.NET MVC 5應用程序，包含vs自帶的標準模版。如果我運行它嘗試導航到一個不存在的路徑 e.g. /foo/bar，就會得到一個包含如下信息的標準 ASP.NET 404 頁面:、
不太友好不是？
這種情況的錯誤是由ASP.NET MVC引發(fā)因為它沒有找到與url相匹配的controller或action。
為了自定義404錯誤頁面，在web.config 的 <system.web></system.web>配置節(jié):
<customErrors mode="On"> <error statusCode="404" redirect="~/404.html"/> </customErrors>
mode="On" 這樣我們就能在本地看到錯誤頁面。一般你可能只想在投入使用時呈現(xiàn)而設置為 mode="RemoteOnly"。
現(xiàn)在如果我再次導航到/foo/bar 就能看到我剛剛定義的錯誤頁面.
然而正如我所料，此時的url路徑并不是 /foo/bar ASP.NET 將其重定向為/404.html?aspxerrorpath=/foo/bar，而且我檢查響應的HTTP狀態(tài)碼也為正常狀態(tài)的200。
這是非常糟糕的，返回http code 200不僅會引起誤解，也不利于SEO。簡單來講，如果指定路徑的資源不存在應該返回404如果是資源被移動應該重定向到新路徑。
要修復這個問題我們可以更改ASP.NET默認行為 重定向錯誤頁 為 重寫返回（rewrite the response）。
<customErrors mode="On" redirectMode="ResponseRewrite"> <error statusCode="404" redirect="~/404.html"/> </customErrors>
然而這并沒有太大的作用（這老外真啰嗦）.盡管原Url地址沒有被重定向, ASP.NET 仍然返回的是 200，此外將我們自定義錯誤頁顯示為純文本。
似乎我們不得不返回一個ASP.NET頁面. 如果你之前以為不用再去 *.aspx頁面的話,那我恐怕讓你失望了。
因此將錯誤頁及相應的web.config改為404.aspx之后，url和content type(text/html)都正常了。
但200的問題依然存在. 這個問題微軟官方給出了相應的解決方案——設置頁面的狀態(tài)碼. 我們在404.aspx加入如下部分:
<% Response.StatusCode = 404 %>
我們現(xiàn)在得到了正確的狀態(tài)碼、url及自定義錯誤頁面,就這樣完事兒了嗎？
錯.
如果我們鏈接到一個靜態(tài)頁路徑(e.g. foo.html) 或一個不匹配我們路由配置的URL (e.g. /foo/bar/foo/bar)，我們會看到到一個標準的IIS 404錯誤頁面.
上述情況繞過了ASP.NET由IIS處理了請求. 當然如果你在controller ation 中 return一個HttpNotFound()也會得到同樣的結(jié)果——這是因為MVC只是簡單的設置status code并沒有拋出錯誤,而是將它交給了IIS.
這種情況我們需要設置iis的錯誤頁面(僅IIS 7+有效).在 web.config <system.webServer></system.webServer>配置節(jié)中:
<httpErrors errorMode="Custom"> <remove statusCode="404"/> <error statusCode="404" path="/404.html" responseMode="ExecuteURL"/> </httpErrors>
同樣設置 errorMode="Custom" 以便本地測試. 正常情況會設置為 errorMode="DetailedLocalOnly".
注意我使用了html頁面，而不是aspx。通常你應該用簡單的靜態(tài)文件作為錯誤頁面，這樣即使ASP.NET出現(xiàn)錯誤時錯誤頁面依然能夠正常顯示。
現(xiàn)在如果我們導航到一個不存在的靜態(tài)文件路徑就會得到一個自定義錯誤頁面而不是IIS默認的404 page，剩下的還是和之前一樣的200問題。
幸運的是 IIS 實際上提供了內(nèi)置的解決方案來解決這一點，如果你設置 responseMode ="File"IIS 將返回您的自定義錯誤頁面，而不改變原始的響應標頭︰
<error statusCode="404" path="404.html" responseMode="File"/>
搞定。
自定義500錯誤頁
大部分無外乎照搬上面的解決方法，添加一個自定義的500錯誤頁面。這里有幾點值得注意的地方。
標準的 ASP.NET MVC模板內(nèi)置的 HandleErrorAttribute 作為一個全局過濾器。捕獲在ASP.NET MVC管道引發(fā)的任何錯誤，并返回一個自定義"錯誤"視圖提供你有在web.config中啟用自定義錯誤。它會尋找 ~/views/{controllerName}/error.cshtml 或 ~ / views/shared/error.cshtml。
如果你使用了過濾器（filter），你需要更新現(xiàn)有的自定義錯誤視圖，并不存在的則需要創(chuàng)建（最好放在views/shared文件夾下）
我沒有看見這個filter有可以設置的屬性值,在 MVC 管道引發(fā)的任何異常都會退回到標準的 ASP.NET 錯誤配置頁面，既然你要設置那些**那這里就用不到這個filter。
添加如下自定義錯誤頁配置：
<customErrors mode="On" redirectMode="ResponseRewrite"> <error statusCode="404" redirect="~/404.aspx"/> <error statusCode="500" redirect="~/500.aspx"/> </customErrors>
類似于前面創(chuàng)建的404.aspx：
<% Response.StatusCode = 500 %> <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>500 Server Error</title> </head> <body> <h1>500 Server Error</h1> </body> </html>
不幸的是這樣做并不會捕獲到你應用程序中的每一個異常。一個相當常見的錯誤——由 ASP.NET 產(chǎn)生的請求的驗證，如一個危險的url路徑/foo/bar<script></script> ，這個實際上會產(chǎn)生一個404響應；因此你可以添加一個默認錯誤配置：
<customErrors mode="Off" redirectMode="ResponseRewrite" defaultRedirect="~/500.aspx"> <error statusCode="404" redirect="~/404.aspx"/> <error statusCode="500" redirect="~/500.aspx"/> </customErrors>
最后為了捕獲非ASP.NET異常我們設置IIS自定義服務器內(nèi)部錯誤500錯誤頁面：
<error statusCode="500" path="500.html" responseMode="File"/>
總結(jié)
在你的應用程序根目錄創(chuàng)建如下錯誤頁面:
404.html - for IIS
404.aspx - for ASP.NET
500.html - for IIS
500.aspx - for ASP.NET
確認您設置在 ASPX 頁面內(nèi)的適當響應狀態(tài)碼.
拋棄 MVC HandleErrorAttribute 全局篩選器；配置 ASP.NET 的自定義錯誤:
<customErrors mode="RemoteOnly" redirectMode="ResponseRewrite" defaultRedirect="~/500.aspx"> <error statusCode="404" redirect="~/404.aspx"/> <error statusCode="500" redirect="~/500.aspx"/> </customErrors>
配置IIS自定義錯誤頁:
<httpErrors errorMode="DetailedLocalOnly"> <remove statusCode="404"/> <error statusCode="404" path="404.html" responseMode="File"/> <remove statusCode="500"/> <error statusCode="500" path="500.html" responseMode="File"/> </httpErrors>
原文鏈接：http://benfoster.io/blog/aspnet-mvc-custom-error-pages
以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
最近做了一個 在線文件管理程序，支持瀏覽服務器所有文件（不單單是站點的文件）。2009-11-11
ASP.NET利用MD.DLL轉(zhuǎn)EXCEL具體實現(xiàn)
首先引入MD.dll 文件(附有下載地址)然后建立無CS文件的DownExcel.aspx 文件，接下來是調(diào)用方法，感興趣的朋友可以參考下哈2013-05-05
本文詳細講解了.Net?Core日志記錄的核心機制，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-06-06
Asp.net中將Word文件轉(zhuǎn)換成HTML的方法
這篇文章主要介紹了Asp.net中將Word文件轉(zhuǎn)換成HTML的方法,需要的朋友可以參考下2014-08-08
動態(tài)生成table并實現(xiàn)分頁效果心得分享
動態(tài)生成table并實現(xiàn)分頁在開發(fā)過程中時一個很好的應用，接下來本文也要實現(xiàn)一個類似效果，感興趣的朋友可以參考下哈2013-04-04
ASP.NET數(shù)據(jù)綁定之GridView控件
這篇文章主要為大家介紹了ASP.NET數(shù)據(jù)綁定中的GridView控件，GridView控件的功能是在web頁面中顯示數(shù)據(jù)源中的數(shù)據(jù)，對GridView控件感興趣的小伙伴們可以參考一下2016-01-01
本篇文章主要介紹了asp.net保存網(wǎng)上圖片到服務器，非常具有實用價值，需要的朋友可以參考下。2016-10-10
這篇文章主要介紹了Asp.Net URL重寫的具體實現(xiàn)，有需要的朋友可以參考一下2014-01-01
這篇文章介紹了ASP.NET?MVC實現(xiàn)下拉框多選的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-09-09
.NET 6開發(fā)TodoList應用之使用AutoMapper實現(xiàn)GET請求
我們希望接受的請求和返回的值具有以下兩點需要遵循的原則：每個model被且只被一個API消費；每個model里僅僅包含API發(fā)起方希望包含的必要字段或?qū)傩?。AutoMapper庫就是為了實現(xiàn)這個需求而存在的。本文將為大家介紹AutoMapper如何實現(xiàn)GET請求，需要的可以參考一下2021-12-12