asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)

以下文章来源于dotnet之美 ,作者Gui.H

dotnet之美.

领略dotnet之美!

当未找到网页并且应用程序返回 404 错误时,ASP.NET Core MVC 仅呈现通用浏览器错误页面,如下图所示

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(1)

这不是很优雅,是吗?我们平时看到的404页面一般是这样的

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(2)

还有这样的

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(3)

试了下京东,地址不存在的时候是会重定向到首页下面就来演示下ASP.NET Core中如何实现这种自定义的404页面处理。新建项目 ASP.NET Core MVC(WebApi处理方式也一样)

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(4)

新建好的项目直接运行的效果

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(5)

随便输入一个地址 /test404

当未找到网页并且应用程序返回 404 错误时,ASP.NET Core MVC 仅呈现通用浏览器错误页面,如下图所示

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(6)

方式一 FallbackEndpointRouteBuilderExtensions.MapFallback

这是个什么东西?

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(7)

意思大概是说这是注册一个优先级最低的通配路由,来匹配所有路由,那就来试试效果吧。

// Program.cs app.UseAuthorization(); app.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); app.MapFallback(async (ctx) => { ctx.Response.Body.Write(Encoding.UTF8.GetBytes("404 from Fallback")); }); app.Run();

试试效果如下

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(8)

方式二 自定义通配路由

在HomeController添加一个Action如下

// HomeController.cs [Route("{*url}", Order = 9999)] public IActionResult Page404() { return View(); }

添加对应的View页面如下

// Page404.cshtml @{ ViewData["Title"] = "404"; } <div>404 for {*url}</div>

效果图

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(9)

上面两种方式虽然能够正常处理404错误页,但是在程序内部抛出的404错误却无法进行拦截

添加一个测试Action如下

[Route("/test404")] public IActionResult test404() { // 一些业务处理,最终返回404 // return NotFound(); return StatusCode(404); }

你看,这种404场景,上述方式没能进行拦截处理。

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(10)

方式三 自定义Middleware拦截

代码如下,关于Middleware如何使用这里不做介绍

app.Use((context, next) => { var res = next(context); if (context.Response.StatusCode == 404) { context.Response.StatusCode = 200; context.Response.Body.Write(Encoding.UTF8.GetBytes("404 from Middleware")); } return res; });

把方式一和方式二的代码注释掉,运行测试效果如下不存在的地址

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(11)

存在的地址,但是业务上返回404

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(12)

方式四 UseStatusCodePagesWithReExecute

注释上个方法的代码

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(13)

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

// HomeController.cs [Route("test401")] public IActionResult test401() { return StatusCode(401); }

public class ErrorController : Controller { [Route("error/404", Order = 9)] public IActionResult Error404() { ViewBag.code = 404; return View(); } [Route("error/{code:int}", Order = 1)] public IActionResult Error(int code) { ViewBag.code = code; switch (code) { case 404: ViewBag.msg = "对不起,请求的资源不存在。"; break; case 401: ViewBag.msg = "对不起,您无权限访问此页面。"; break; default: ViewBag.msg = "服务异常,请稍后重试!"; break; } return View("Error404"); } }

// Error404.cshtml @{ } <div>@ViewBag.code : @ViewBag.msg</div>

测试效果

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(14)

asp.net错误机制(ASP.NETCore统一处理404错误都有哪些方式)(15)

完美!!!!

方式五 web.config <customErrors> 节点中配置ASP.NET管道处理404错误

这是以前framwork时代的iis配置方式,不推荐使用了,也不进行测试了。

总结

个人认为方式三、四推荐使用,四更加优雅,三是最灵活的,还有没有其他方式进行拦截统一处理404错误呢,欢迎补充。

本文源码已上传 github

https://github.com/SpringHgui/404test

,

免责声明:本文仅代表文章作者的个人观点,与本站无关。其原创性、真实性以及文中陈述文字和内容未经本站证实,对本文以及其中全部或者部分内容文字的真实性、完整性和原创性本站不作任何保证或承诺,请读者仅作参考,并自行核实相关内容。文章投诉邮箱:anhduc.ph@yahoo.com

    分享
    投诉
    首页