0

0

ASP.NET MVC自定义错误页面

高洛峰

高洛峰

发布时间:2016-12-24 13:48:51

|

1685人浏览过

|

来源于php中文网

原创

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

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


  
  

   

eshop网上书店源码
eshop网上书店源码

适合初学的标准三层架构,采用ajax,页面布局div+css符合w3c,用vs自带的sqlserver,免配置sqlserver,使用方便,里面共有5个项目,点击最外层的.sln直接可运行。网站采用asp.net 用户角色配置(membership,UserRoles),用户角色、权限可在asp.net配置里修改,注册,登陆均采用asp.net登陆控件,网站根据用户角色自定义sitemap,基本上

下载

自定义404错误页面

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

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




  
  404 Page Not Found


  

404 Page Not Found

   

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

ASP.NET MVC自定义错误页面

不太友好不是?

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

为了自定义404错误页面,在web.config 的 配置节:


 

   

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)。


 

   

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

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

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

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


我们现在得到了正确的状态码、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 配置节中:


 
 

   

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

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

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

幸运的是 IIS 实际上提供了内置的解决方案来解决这一点,如果你设置 responseMode ="File"IIS 将返回您的自定义错误页面,而不改变原始的响应标头︰

搞定。

自定义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。

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


 
 

   

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

<% Response.StatusCode = 500 %>



  
  500 Server Error


  

500 Server Error

   

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


 
 

   

 最后为了捕获非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 的自定义错误:


 
 

   

配置IIS自定义错误页:


 
 
 
 

   

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持PHP中文网。

更多ASP.NET MVC自定义错误页面相关文章请关注PHP中文网!

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

79

2026.01.09

c++框架学习教程汇总
c++框架学习教程汇总

本专题整合了c++框架学习教程汇总,阅读专题下面的文章了解更多详细内容。

46

2026.01.09

学python好用的网站推荐
学python好用的网站推荐

本专题整合了python学习教程汇总,阅读专题下面的文章了解更多详细内容。

121

2026.01.09

学python网站汇总
学python网站汇总

本专题整合了学python网站汇总,阅读专题下面的文章了解更多详细内容。

12

2026.01.09

python学习网站
python学习网站

本专题整合了python学习相关推荐汇总,阅读专题下面的文章了解更多详细内容。

15

2026.01.09

俄罗斯手机浏览器地址汇总
俄罗斯手机浏览器地址汇总

汇总俄罗斯Yandex手机浏览器官方网址入口,涵盖国际版与俄语版,适配移动端访问,一键直达搜索、地图、新闻等核心服务。

71

2026.01.09

漫蛙稳定版地址大全
漫蛙稳定版地址大全

漫蛙稳定版地址大全汇总最新可用入口,包含漫蛙manwa漫画防走失官网链接,确保用户随时畅读海量正版漫画资源,建议收藏备用,避免因域名变动无法访问。

370

2026.01.09

php学习网站大全
php学习网站大全

精选多个优质PHP入门学习网站,涵盖教程、实战与文档,适合零基础到进阶开发者,助你高效掌握PHP编程。

45

2026.01.09

php网站搭建教程大全
php网站搭建教程大全

本合集专为零基础用户打造,涵盖PHP网站搭建全流程,从环境配置到实战开发,免费、易懂、系统化,助你快速入门建站!

12

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HTML 中文开发手册
HTML 中文开发手册

共0课时 | 0人学习

极客学院ASP.NET视频教程
极客学院ASP.NET视频教程

共90课时 | 20.4万人学习

http状态码大全
http状态码大全

共47课时 | 107.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号