ASP.NET Core 處理 404 Not Found


問題

在沒有修改任何配置的情況下,這是用戶使用 Chrome 訪問不存在的URL時會看到的內容:

Chrome Default 404 Screen

幸運的是,處理錯誤狀態代碼非常簡單,我們將在下面介紹三種技術。

解決方案

在以前的ASP.NET MVC版本中,主要在 web.config 中處理404錯誤的。

您可能記得在 <customErrors> 節點中配置ASP.NET管道處理404錯誤,以及在低版本的IIS中通過 <httpErrors> 節點處理 404錯誤。好像有點混亂。

在.Net Core中,情況就不同了,沒有必要使用XML配置(盡管如果您是通過IIS代理,您仍然可以在web.config中使用 httpErrors,並且您真的想這樣嗎:-))。

在處理 not-found 錯誤時,我們需要處理兩種不同的情況。

URL與任何路由不匹配的情況。在這種情況下,如果我們無法確定用戶正在訪問什么,我們需要返回一個通用的未找到的頁面。有兩種常見的處理方法,但首先我們將討論第二種情況。URL與路由匹配的情況,但是一個或多個參數無效,我們可以用自定義視圖來解決這個問題。

自定義視圖

這種情況的一個例子是具有無效或過期ID的產品頁面。在這里,我們知道用戶正在查看產品,而不是返回通用錯誤,我們可以更友好的頁面,返回自定義未找到產品的的頁面。這仍然需要返回404狀態代碼,但是使用不通用的頁面,同時也可以向用戶顯示類似或受歡迎的產品。

處理這些情況是非常瑣碎,我們需要做的是在返回我們的自定義視圖之前設置狀態代碼:

    public async Task<IActionResult> GetProduct(int id)
    {
        var viewModel = await _db.Get<Product,GetProductViewModel>(id);
    
        if (viewModel == null)
        {
            Response.StatusCode = 404;
            return View("ProductNotFound");
        }
    
        return View(viewModel);
    }

當然,您可能更喜歡將其包裝成自定義ActionResult:

    public class NotFoundViewResult : ViewResult
    {
        public NotFoundViewResult(string viewName)            
        {
            ViewName = viewName;
            StatusCode = (int)HttpStatusCode.NotFound;
        }
    }

這簡化了我們的Action:

    public async Task<IActionResult> GetProduct(int id)
    {
        var viewModel = await _db.Get<Product,GetProductViewModel>(id);
    
        if (viewModel == null)
        {
            return new NotFoundViewResult("ProductNotFound");
        }
    
        return View(viewModel);
    }

這個簡單的技術涵蓋了特定的404頁,現在來看看通用的404錯誤,我們無法弄清楚用戶想要查看的內容。

通配路由

在先前版本的MVC,創建一個通配符路由來處理,在.NET Core中,也可以使用相同的方式。這個方式是,您有一個通配符路由,它會接收任何其它路由尚未處理的URL。使用特性路由,方式如下:

    [Route("{*url}", Order = 999)]
    public IActionResult CatchAll()
    {
        Response.StatusCode = 404;
        return View();
    }

重要的是指定順序,以確保其它路由優先。

一個通配符路由的方式非常不錯,但它不是.NET Core中的首選。雖然全部路由將處理404,但下一個方式將處理任何非成功狀態代碼,以便您可以執行以下Action(可能在生產中的Action過濾器中):

    public async Task<IActionResult> GetProduct(int id)
    {
        ...
    
        if (RequiresThrottling())
        {
            return new StatusCodeResult(429)
        }
    
        if (!HasPermission(id))
        {
            return Forbid();
        }
    
        ...
    }

StatusCodePagesWithReExecute方法 中件間

UseStatusCodePagesWithReExecute使用了一個非常聰明的中間件(StatusCodePagesMiddleware),在未輸出響應前,它能處理非成功狀態代碼。這意味着如果您使用上面詳細描述的自定義視圖技術,則404狀態代碼將不會被中間件處理(這正是我們想要的)。

當從內部中間件組件返回錯誤代碼(如404)時,UseStatusCodePagesWithReExecute允許您執行另一個控制器Action來處理狀態代碼。

您可以在startup.cs中使用一行代碼將其添加到管道中:

    app.UseStatusCodePagesWithReExecute("/error/{0}");
    ...
    app.UseMvc();

中間件定義的順序很重要,您需要確保在可能返回錯誤代碼的任何中間件(如MVC中間件)之前注冊StatusCodeWithReExecute

您可以指定一個固定路徑來執行或使用狀態代碼值的占位符,如上所述。

您還可以指向靜態頁面(假設您已經具有StaticFileMiddleware中間件)和控制器Action。

在這個例子中,我們有一個單獨的Action處理404。任何其它非成功狀態代碼,使用 Error Action。

    [Route("error/404")]
    public IActionResult Error404()
    {
        return View();
    }
    
    [Route("error/{code:int}")]
    public IActionResult Error(int code)
    {
        // handle different codes or just return the default error view
        return View();
    }

顯然,您可以根據您的需要量身定制。例如,如果您正在使用上一節所示的請求限制,那么您可以返回一個解釋為什么請求失敗的429頁面。

總結

處理404頁面的具體問題最好用自定義視圖來處理,並設置狀態代碼(直接或通過自定義操作結果)。

通過使用StatusCodePagesMiddleware中間件,可以非常容易地處理通用404錯誤(或實際上是任何非成功狀態代碼)。一般來說,這兩種技術是在ASP.NET Core中處理非成功HTTP狀態代碼的首選方法。

原文:《Handling 404 Not Found in Asp.Net Core》https://www.devtrends.co.uk/blog/handling-404-not-found-in-asp.net-core
翻譯:Sweet Tang
本文地址:http://www.cnblogs.com/tdfblog/p/handling-404-not-found-in-asp-net-core.html
歡迎轉載,請在明顯位置給出出處及鏈接。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM