在ASP.NET Core中显示自定义的错误页面
前言
相信每位程序员们应该都知道在ASP.NETCore中,默认情况下当发生500或404错误时,只返回http状态码,不返回任何内容,页面一片空白。
如果在Startup.cs的Configure()中加上app.UseStatusCodePages();,500错误时依然是一片空白(不知为何对500错误不起作用),404错误时有所改观,页面会显示下面的文字:
StatusCode:404;NotFound
如果我们想实现不管500还是404错误都显示自己定制的友好错误页面,那该怎么办呢?
对于500错误,我们可以用app.UseExceptionHandler()进行截获;
对于404错误,我们可以用app.UseStatusCodePages()的增强版app.UseStatusCodePagesWithReExecute()进行截获;
然后转交给相应的URL进行处理。
app.UseExceptionHandler("/errors/500"); app.UseStatusCodePagesWithReExecute("/errors/{0}");
URL路由到MVCController中显示友好错误页面。
publicclassErrorsController:Controller { [Route("errors/{statusCode}")] publicIActionResultCustomError(intstatusCode) { if(statusCode==404) { returnView("~/Views/Errors/404.cshtml"); } returnView("~/Views/Errors/500.cshtml"); } }
【更新】
后来发现一个问题,当出现底层异常时,自定义错误页面不能显示,还是一片空白,比如下面的异常:
System.DllNotFoundException:UnabletoloadDLL'System.Security.Cryptography.Native.Apple':Thespecifiedmodulecouldnotbefound. (ExceptionfromHRESULT:0x8007007E)
这时想到用MVC显示自定义错误页面的局限,如果发生的异常导致MVC本身不能正常工作,自定义错误页面就无法显示。
于是针对这个问题进行了改进,针对500错误直接用静态文件的方式进行响应,Startup.cs的Configure()中的代码如下:
app.UseExceptionHandler(errorApp=> { errorApp.Run(asynccontext=> { context.Response.StatusCode=500; if(context.Request.Headers["X-Requested-With"]!="XMLHttpRequest") { context.Response.ContentType="text/html"; awaitcontext.Response.SendFileAsync($@"{env.WebRootPath}/errors/500.html"); } }); }); app.UseStatusCodePagesWithReExecute("/errors/{0}");
为了重用自定义错误页面,MVCController中已进行了修改:
publicclassErrorsController:Controller { privateIHostingEnvironment_env; publicErrorsController(IHostingEnvironmentenv) { _env=env; } [Route("errors/{statusCode}")] publicIActionResultCustomError(intstatusCode) { varfilePath=$"{_env.WebRootPath}/errors/{(statusCode==404?404:500)}.html"; returnnewPhysicalFileResult(filePath,newMediaTypeHeaderValue("text/html")); } }
总结
以上就是关于ASP.NETCore中显示自定义错误页面的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流。