主页 / 网络编程 /

在ASP.NET Core中显示自定义的错误页面

网络编程 2021-07-04 22:41www.168986.cn编程入门
大家在用浏览器访问服务器时，不同情况下会返回不同的信息。服务器发生错误就会返回错误信息，我们最熟悉的就是404错误页面，这里我想和大家分享下在ASP.NET Core中如何显示自定义的500或404错误页面，有需要的朋友们可以参考借鉴，狼蚁网站SEO优化来一起看看吧。

前言

相信每位程序员们应该都知道在 ASP.NET Core 中，默认情况下当发生500或404错误时，只返回http状态码，不返回任何内容，页面一片空白。

如果在 Startup.cs 的 Configure() 中加上 app.UseStatusCodePages(); ，500错误时依然是一片空白（不知为何对500错误不起作用），404错误时有所改观，页面会显示狼蚁网站SEO优化的文字

Status Code: 404; Not Found

如果我们想实现不管500还是404错误都显示自己定制的友好错误页面，那该怎么办呢？

对于500错误，我们可以用 app.UseExceptionHandler() 进行截获；

对于404错误，我们可以用 app.UseStatusCodePages() 的增强版 app.UseStatusCodePagesWithReExecute() 进行截获；

然后转交给相应的URL进行处理。

app.UseExceptionHandler("/errors/500");
app.UseStatusCodePagesWithReExecute("/errors/{0}");

URL 路由到 MVC Controller 中显示友好错误页面。

public class ErrorsController : Controller
{
 [Route("errors/{statusCode}")]
 public IActionResult CustomError(int statusCode)
 {
  if(statusCode == 404)
  {
   return View("~/Views/Errors/404.cshtml");
  }
  return View("~/Views/Errors/500.cshtml");
 }  
}

【更新】

后来发现一个问题，当出现底层异常时，自定义错误页面不能显示，还是一片空白，比如狼蚁网站SEO优化的异常

System.DllNotFoundException: Unable to load DLL 'System.Security.Cryptography.Native.Apple': The specified module could not be found.
 (Exception from HRESULT: 0x8007007E)

这时想到用 MVC 显示自定义错误页面的局限，如果发生的异常导致 MVC 本身不能正常工作，自定义错误页面就无法显示。

于是针对这个问题进行了改进，针对500错误直接用静态文件的方式进行响应，Startup.cs 的 Configure() 中的代码如下

app.UseExceptionHandler(errorApp =>
{
 errorApp.Run(async context =>
 {
  context.Response.StatusCode = 500;
  if (context.Request.Headers["X-Requested-With"] != "XMLHttpRequest")
  {
   context.Response.ContentType = "text/html";
   await context.Response.SendFileAsync($@"{env.WebRootPath}/errors/500.html");
  }
 });
});
app.UseStatusCodePagesWithReExecute("/errors/{0}");

为了重用自定义错误页面，MVC Controller 中已进行了修改

public class ErrorsController : Controller
{
 private IHostingEnvironment _env;

 public ErrorsController(IHostingEnvironment env)
 {
  _env = env;
 }

 [Route("errors/{statusCode}")]
 public IActionResult CustomError(int statusCode)
 {
  var filePath = $"{_env.WebRootPath}/errors/{(statusCode == 404?404:500)}.html";
  return new PhysicalFileResult(filePath, new MediaTypeHeaderValue("text/html"));
 }  
}

以上就是关于ASP.NET Core中显示自定义错误页面的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流。

上一篇：Linux Ubuntu系统上手动安装.NET Core SDK的方法 下一篇：Asp.net实现无刷新调用后台实体类数据并以Json格式

编程语言

Copyright © 2016-2025 www.168986.cn 狼蚁网络 版权所有 Power by