https://github.com/springhgui/404test
404处理测试
https://github.com/springhgui/404test
Last synced: 7 months ago
JSON representation
404处理测试
- Host: GitHub
- URL: https://github.com/springhgui/404test
- Owner: SpringHgui
- Created: 2022-04-13T15:47:08.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-05-10T13:10:58.000Z (over 3 years ago)
- Last Synced: 2025-07-03T01:34:51.296Z (7 months ago)
- Language: HTML
- Size: 893 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ASP.NETCore统一处理404错误都有哪些方式？
### 当未找到网页并且应用程序返回 404 错误时，ASP.NET Core MVC 仅呈现通用浏览器错误页面，如下图所示
### 这不是很优雅，是吗？
### 我们平时看到的404页面一般是这样的
### 还有这样的
### 试了下京东，地址不存在的时候是会重定向到首页
## 下面就来演示下ASP.NET Core中如何实现这种自定义的404页面处理。
### 新建项目 ASP.NET Core MVC（WebApi处理方式也一样）
####新建好的项目直接运行的效果
####随便输入一个地址 `/test404`
当未找到网页并且应用程序返回 404 错误时，ASP.NET Core MVC 仅呈现通用浏览器错误页面，如下图所示
## 方式一 [FallbackEndpointRouteBuilderExtensions.MapFallback](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.builder.fallbackendpointroutebuilderextensions.mapfallback?f1url=%3FappId%3DDev16IDEF1%26l%3DZH-CN%26k%3Dk(Microsoft.AspNetCore.Builder.FallbackEndpointRouteBuilderExtensions.MapFallback);k(DevLang-csharp)%26rd%3Dtrue&view=aspnetcore-6.0)
这是个什么东西?
意思大概是说这是注册一个优先级最低的通配路由，来匹配所有路由，那就来试试效果吧。
```c#
// 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();
```
### 试试效果如下
## 方式二 自定义通配路由
在`HomeController`添加一个Action如下
```
// HomeController.cs
[Route("{*url}", Order = 9999)]
public IActionResult Page404()
{
return View();
}
```
添加对应的View页面如下
```
// Page404.cshtml
@{
ViewData["Title"] = "404";
}
404 for {*url}
```
### 效果图
### 上面两种方式虽然能够正常处理404错误页，但是在程序内部抛出的404错误却无法进行拦截
添加一个测试Action如下
```
[Route("/test404")]
public IActionResult test404()
{
// 一些业务处理，最终返回404
// return NotFound();
return StatusCode(404);
}
```
你看，这种404场景，上述方式没能进行拦截处理。
## 方式三 自定义[Middleware](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.builder.useextensions.use?view=aspnetcore-6.0#microsoft-aspnetcore-builder-useextensions-use(microsoft-aspnetcore-builder-iapplicationbuilder-system-func((microsoft-aspnetcore-http-httpcontext-microsoft-aspnetcore-http-requestdelegate-system-threading-tasks-task))))拦截
代码如下，关于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;
});
```
把方式一和方式二的代码注释掉，运行测试效果如下
不存在的地址
存在的地址，但是业务上返回404
## 方式四 [UseStatusCodePagesWithReExecute](https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.builder.statuscodepagesextensions.usestatuscodepageswithreexecute?view=aspnetcore-6.0)
注释上个方法的代码
```
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
@{
}
@ViewBag.code : @ViewBag.msg
```
### 测试效果
完美！！！！
## 方式五 `web.config` `` 节点中配置ASP.NET管道处理404错误
这是以前framwork时代的iis配置方式，不推荐使用了，也不进行测试了。
## 总结
个人认为方式三、四推荐使用，四更加优雅，三是最灵活的，还有没有其他方式进行拦截统一处理404错误呢，欢迎补充。
## 本文源码已上传github