ASP.NET MVC自定义错误页面真的简单吗?

2024-10-05 21:59:38

如果你在设置asp.net mvc自定义错误页面时遇到问题，这并不止你一个人。惊讶之余你的做法是正确的，没有起到作用的原因是其一部分错误是由asp.net管道处理的，另一部分是由iis直接处理。

通常情况（我期望是这种情况，在一些其他框架/服务器上）我们只需要在一个地方配置自定义错误页就可以了，无论怎么哪儿引发的错误。就像这样︰

<customErrors mode="On">
  <error code="404" path="404.html" />
  <error code="500" path="500.html" />
</customErrors>

自定义404错误页面

当一个资源不存在时（包含静态和动态），我们需要返回一个404状态的页面，通常我们需要提供一些稍微友好的信息替代asp.net/iis生成的默认错误页呈现给我们的网站访问者，可能是提出一些忠告为什么该资源可能不存在或提供选择要搜索的网站。

这里仅作演示简单设置如下：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8"/>
  <title>404 Page Not Found</title>
</head>
<body>
  <h1>404 Page Not Found</h1>
</body>
</html>

我创建了一个新的ASP.NET MVC 5应用程序，包含vs自带的标准模版。如果我运行它尝试导航到一个不存在的路径 e.g. /foo/bar，就会得到一个包含如下信息的标准 ASP.NET 404 页面:、

不太友好不是？

这种情况的错误是由ASP.NET MVC引发因为它没有找到与url相匹配的controller或action。

为了自定义404错误页面，在web.config 的 <system.web></system.web>配置节:

<customErrors mode="On">
 <error statusCode="404" redirect="~/404.html"/>
</customErrors>

mode="On" 这样我们就能在本地看到错误页面。一般你可能只想在投入使用时呈现而设置为 mode="RemoteOnly"。

现在如果我再次导航到/foo/bar 就能看到我刚刚定义的错误页面.

然而正如我所料，此时的url路径并不是 /foo/bar ASP.NET 将其重定向为/404.html?aspxerrorpath=/foo/bar，而且我检查响应的HTTP状态码也为正常状态的200。

这是非常糟糕的，返回http code 200不仅会引起误解，也不利于SEO。简单来讲，如果指定路径的资源不存在应该返回404如果是资源被移动应该重定向到新路径。

要修复这个问题我们可以更改ASP.NET默认行为重定向错误页为重写返回（rewrite the response）。

<customErrors mode="On" redirectMode="ResponseRewrite">
 <error statusCode="404" redirect="~/404.html"/>
</customErrors>

然而这并没有太大的作用（这老外真啰嗦）.尽管原Url地址没有被重定向, ASP.NET 仍然返回的是 200，此外将我们自定义错误页显示为纯文本。

似乎我们不得不返回一个ASP.NET页面. 如果你之前以为不用再去 *.aspx页面的话,那我恐怕让你失望了。

因此将错误页及相应的web.config改为404.aspx之后，url和content type(text/html)都正常了。

但200的问题依然存在. 这个问题微软官方给出了相应的解决方案——设置页面的状态码. 我们在404.aspx加入如下部分:

<% Response.StatusCode = 404 %>

我们现在得到了正确的状态码、url及自定义错误页面,就这样完事儿了吗？

错.

如果我们链接到一个静态页路径(e.g. foo.html) 或一个不匹配我们路由配置的URL (e.g. /foo/bar/foo/bar)，我们会看到到一个标准的IIS 404错误页面.

上述情况绕过了ASP.NET由IIS处理了请求. 当然如果你在controller ation 中 return一个HttpNotFound()也会得到同样的结果——这是因为MVC只是简单的设置status code并没有抛出错误,而是将它交给了IIS.

这种情况我们需要设置iis的错误页面(仅IIS 7+有效).在 web.config <system.webServer></system.webServer>配置节中:

<httpErrors errorMode="Custom">
 <remove statusCode="404"/>
 <error statusCode="404" path="/404.html" responseMode="ExecuteURL"/>
</httpErrors>

同样设置 errorMode="Custom" 以便本地测试. 正常情况会设置为 errorMode="DetailedLocalOnly".

注意我使用了html页面，而不是aspx。通常你应该用简单的静态文件作为错误页面，这样即使ASP.NET出现错误时错误页面依然能够正常显示。

现在如果我们导航到一个不存在的静态文件路径就会得到一个自定义错误页面而不是IIS默认的404 page，剩下的还是和之前一样的200问题。

幸运的是 IIS 实际上提供了内置的解决方案来解决这一点，如果你设置 responseMode ="File"IIS 将返回您的自定义错误页面，而不改变原始的响应标头︰
<error statusCode="404" path="404.html" responseMode="File"/>
搞定。

自定义500错误页

大部分无外乎照搬上面的解决方法，添加一个自定义的500错误页面。这里有几点值得注意的地方。

标准的 ASP.NET MVC模板内置的 HandleErrorAttribute 作为一个全局过滤器。捕获在ASP.NET MVC管道引发的任何错误，并返回一个自定义"错误"视图提供你有在web.config中启用自定义错误。它会寻找 ~/views/{controllerName}/error.cshtml 或 ~ / views/shared/error.cshtml。

如果你使用了过滤器（filter），你需要更新现有的自定义错误视图，并不存在的则需要创建（最好放在views/shared文件夹下）

我没有看见这个filter有可以设置的属性值,在 MVC 管道引发的任何异常都会退回到标准的 ASP.NET 错误配置页面，既然你要设置那些**那这里就用不到这个filter。

添加如下自定义错误页配置：

<customErrors mode="On" redirectMode="ResponseRewrite">
 <error statusCode="404" redirect="~/404.aspx"/>
 <error statusCode="500" redirect="~/500.aspx"/>
</customErrors>

类似于前面创建的404.aspx：

<% Response.StatusCode = 500 %>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8" />
  <title>500 Server Error</title>
</head>
<body>
  <h1>500 Server Error</h1>
</body>
</html>

不幸的是这样做并不会捕获到你应用程序中的每一个异常。一个相当常见的错误——由 ASP.NET 产生的请求的验证，如一个危险的url路径/foo/bar<script></script> ，这个实际上会产生一个404响应；因此你可以添加一个默认错误配置：

<customErrors mode="Off" redirectMode="ResponseRewrite" defaultRedirect="~/500.aspx">
 <error statusCode="404" redirect="~/404.aspx"/>
 <error statusCode="500" redirect="~/500.aspx"/>
</customErrors>

最后为了捕获非ASP.NET异常我们设置IIS自定义服务器内部错误500错误页面：

总结

在你的应用程序根目录创建如下错误页面:

404.html - for IIS
404.aspx - for ASP.NET
500.html - for IIS
500.aspx - for ASP.NET

确认您设置在 ASPX 页面内的适当响应状态码.

抛弃 MVC HandleErrorAttribute 全局筛选器；配置 ASP.NET 的自定义错误:

<customErrors mode="RemoteOnly" redirectMode="ResponseRewrite" defaultRedirect="~/500.aspx">
 <error statusCode="404" redirect="~/404.aspx"/>
 <error statusCode="500" redirect="~/500.aspx"/>
</customErrors>

配置IIS自定义错误页:

<httpErrors errorMode="DetailedLocalOnly">
 <remove statusCode="404"/>
 <error statusCode="404" path="404.html" responseMode="File"/>
 <remove statusCode="500"/>
 <error statusCode="500" path="500.html" responseMode="File"/>
</httpErrors>

原文链接：http://benfoster.io/blog/aspnet-mvc-custom-error-pages

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。

详解ASP.NET MVC的筛选器

在ActionInvoker对Action的执行过程中,除了通过利用ActionDescriptor对Action方法的执行,以及之前进行的Model绑定与验证之外,还具有一个重要的工作,那就是对相关筛选器(Filter)的执行.ASP.NET MVC的筛选器是一种基于AOP(面向方面编程)的设计,我们将一些非业务的逻辑实现在相应的筛选器中,然后以一种横切(Crosscutting)的方式应用到对应的Action方法.当Action方法执行前后,这些筛选器会自动执行.ASP.NET MVC提供了
Asp.net MVC中获取控制器的名称的方法

1.视图中 string controller = ViewContext.RouteData.Route.GetRouteData(this.Context).Values["controller"].ToString(); string controller = ViewContext.RouteData.Values["controller"].ToString(); 2.控制器的action中 string controller = RouteData.Ro
ASP.NET MVC阿里大于短信接口开发短信群发能

互联网上有许多公司提供短信接口服务,诸如网易云信.阿里大于等等.我在自己项目里需要使用到短信服务起到通知作用,实际开发周期三天,完成配置.开发和使用,总的说,阿里大于提供的接口易于开发,非常的方便,短信费用是计数缴纳的,作为个人开发者,我使用的服务业务产生的费用为0.045￥/条(10万条以下). 现在要实现一个例会短信群发通知的功能,所有被通知对象信息均存于Mysql中,应用架构采用asp.net MVC .首先准备好获取的API各项(以下各项服务参数都需要在大于官网上申请), 申请好自己的短
ASP.NET MVC 微信JS-SDK认证

ASP.NET MVC微信JS-SDK认证,具体内容: 写在前面前阵子因为有个项目需要做微信自定义分享功能,因而去研究了下微信JS-SDK相关知识. 此文做个简单的记(tu)录(cao)... 开始所有的东西都从文档开始:微信JSSDK说明文档项目需要用到的是分享接口不过使用微信JS-SDK之前,需要做JS接口认证. 认证如下: 步骤一:绑定域名步骤二:引入JS文件步骤三:通过config接口注入权限验证配置步骤四:通过ready接口处理成功验证步骤五:通过error接口处理失败验
灵活掌握Asp.net MVC中GridView的使用方法

本文教程为大家分享了GridView控件的使用方法和具体实现代码,供大家参考,具体内容如下 Models文件下实体类: public class Customer { public int Id { get; set; } public string CompanyName { get; set; } public string ContactTitle { get; set; } public string Address { get; set; } public string City {
ASP.NET MVC使用EPPlus，导出数据到Excel中

好久没写博客了,今天特地来更新一下,今天我们要学习的是如何导出数据到Excel文件中,这里我使用的是免费开源的Epplus组件. 源代码下载:https://github.com/caofangsheng93/ExcelExportInMvc 介绍这篇文章,介绍的是怎样导出数据到Excel文件中,大多数的后端程序都有报表功能:把显示在Grid中的数据导出到Excel文件中,这篇文章中使用的是EPPlus组件. EPPlus是一个基于OOXML[Open Extended Markup Lang
[Asp.Net MVC4]验证用户登录实现实例

最近我们要做一个仿sina的微博,碰巧的是我最近在学习mvc,就想用mvc技术实现这个项目. 既然是微博,那不用想也应该知道肯定要有用户登陆,但是和常规的asp.NET登陆又不一样,以下是我一下午+一晚上的研究成果~~~ 首先,建好数据库以及表,这就不用说了吧. 下面说一下主要的结构控制器: HomeController 这是主页的控制器 LoginController 这是登陆的控制器类: CDBTemplate.cs 这是数据库数据对应的类,里边描述的是数据库的结构 //////////
ASP.NET Core MVC 配置全局路由前缀

ASP.NET Core MVC 配置全局路由前缀前言大家好,今天给大家介绍一个 ASP.NET Core MVC 的一个新特性,给全局路由添加统一前缀.严格说其实不算是新特性,不过是Core MVC特有的. 应用背景不知道大家在做 Web Api 应用程序的时候,有没有遇到过这种场景,就是所有的接口都是以 /api 开头的,也就是我们的api 接口请求地址是像这样的: http://www.example.com/api/order/333 或者是这样的需求 http://www.exa
ASP.NET MVC下的四种验证编程方式[续篇]

在<ASP.NET MVC的四种验证编程方式>一文中我们介绍了ASP.NET MVC支持的四种服务端验证的编程方式("手工验证"."标注ValidationAttribute特性"."让数据类型实现IValidatableObject或者IDataErrorInfo"),那么在ASP.NET MVC框架内部是如何提供针对这四种不同编程方式的支持的呢?接下来我们就来聊聊这背后的故事. 一.ModelValidator与ModelVali
ASP.NET MVC后台参数验证的几种方式

前言参数验证是一个常见的问题,无论是前端还是后台,都需对用户输入进行验证,以此来保证系统数据的正确性.对于web来说,有些人可能理所当然的想在前端验证就行了,但这样是非常错误的做法,前端代码对于用户来说是透明的,稍微有点技术的人就可以绕过这个验证,直接提交数据到后台.无论是前端网页提交的接口,还是提供给外部的接口,参数验证随处可见,也是必不可少的.总之,一切用户的输入都是不可信的. 参数验证有许多种方式进行,下面以mvc为例,列举几种常见的验证方式,假设有一个用户注册方法 [HttpPost]
Asp.NET MVC中使用SignalR实现推送功能

一.简介 Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Push)消息到客户端页面,这样客户端就不必重新发送请求或使用轮询技术来获取消息. 可访问其官方网站:https://github.com/SignalR/ 获取更多资讯. 二.Asp.net SignalR 是个什么东东 Asp.net SignalR是微软为实现实时通信的一个类库.一般情况下,SignalR会使用JavaScript的长轮询(lo

ASP.NET MVC自定义错误页面真的简单吗?

相关推荐

随机推荐