当前位置： 首页 > news >正文

asp.net 404页面配置、 asp.net MVC 配置404页面、iis 配置404页面，指定404错误页面，设置404错误页面

news 来源：原创 2024/5/20 13:19:06

通过标题的三个问题

1、asp.net 404页面配置、  

2、asp.net MVC 配置404页面、

3、iis 配置404页面；

可以看出，这是一篇了不得的问题，并进行全面讲解；

 除了围绕以上三个核心问题外，我们也对以下2个核心场景也作出分析；

1.MVC模式

2.传统模式；

往往这2种模式是混合一起使用的。

一、MVC模式

如：www.jijiyuan.com/news/details/1

按照URL分析：

这个站点下有个“news”文件夹，在“news”文件夹下有个“details”，接着下面有个1

其实，这样的路径是由MVC管道处理后的路径，在项目中他是这样的；

“news”是控制器

“details”是动作，或者说是方法，你也可以理解成页面

“1”是参数

代码如下：

    public class NewsController : Controller{// GET: Newspublic ActionResult Index(){return View();}public ActionResult Details(int id){return View();}}

二、传统模式

如：www.jijiyuan.com/1.html

这1.html是真实存在的，如果不存在会提示404错误；如下图

三、解决“控制器”或“路径”不存在，跳转指定页面

 3.1、项目结构介绍

如上图，我这里有一个名为“Error”的控制器；代码如下

cs代码

    public class ErrorController : Controller{// GET: Errorpublic ActionResult Rrror404(){return View();}}

html代码

<!DOCTYPE html><html>
<head><meta name="viewport" content="width=device-width" /><title>Rrror404</title>
</head>
<body><h1> Rrror404 </h1><p>你访问的页面不存在，点击跳转<a href="/">首页</a></p><h3><a href="/">去首页</a></h3>
</body>
</html>

3.2、【推荐】配置根目录的Web.config解决404错误问题

在你的站点找到Web.config文件，文档结构如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration><system.web><compilation debug="true" targetFramework="4.5"/><httpRuntime targetFramework="4.5"/> </system.web><system.webServer><handlers><remove name="ExtensionlessUrlHandler-Integrated-4.0"/><remove name="OPTIONSVerbHandler"/><remove name="TRACEVerbHandler"/><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler"preCondition="integratedMode,runtimeVersionv4.0"/></handlers> </system.webServer>
</configuration>

我们需要将下面代码加入到【system.web】节点里面

<customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" />
</customErrors>

加入后完整代码如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration><system.web><compilation debug="true" targetFramework="4.5"/><httpRuntime targetFramework="4.5"/> <customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" /></customErrors></system.web><system.webServer><handlers><remove name="ExtensionlessUrlHandler-Integrated-4.0"/><remove name="OPTIONSVerbHandler"/><remove name="TRACEVerbHandler"/><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler"preCondition="integratedMode,runtimeVersionv4.0"/></handlers> </system.webServer>
</configuration>

3.2.1、注意

注意：redirect="url"里面的url不要填文件地址，而是要填写请求404页面的控制器。 

3.2.2 、mode属性说明：

本地调试时，用RemoteOnly属性；发布时，用On

On：指定启用自定义错误。如果没有指定 defaultRedirect，用户将看到一般性错误。
Off：指定禁用自定义错误。这允许显示详细的错误。
RemoteOnly：指定仅向远程客户端端显示自定义错误，并向本地主机显示 ASP.NET 错误。这是默认值。 

3.2.3、再次访问 

我们访问错误网站路径

访问 

http://localhost:58146/Home/Index2

网站会字段跳转到

http://localhost:58146/Error/Rrror404?aspxerrorpath=/Home/Index2

 3.3、【不推荐】修改Global.asax解决404错误问题

如果你配置了Web.config，则不需要修改Global.asax

如访问

http://localhost:58146/Home/Index2

在Global.asax文件中增加如下代码

protected void Application_Error(object sender, EventArgs e)
{Exception ex = Server.GetLastError();if (ex is HttpException && ((HttpException)ex).GetHttpCode() == 404){Response.Redirect("/Error/Rrror404");}
}

完整代码

public class MvcApplication : System.Web.HttpApplication
{protected void Application_Start(){AreaRegistration.RegisterAllAreas();GlobalConfiguration.Configure(WebApiConfig.Register);FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);RouteConfig.RegisterRoutes(RouteTable.Routes);BundleConfig.RegisterBundles(BundleTable.Bundles);}protected void Application_Error(object sender, EventArgs e){Exception ex = Server.GetLastError();if (ex is HttpException && ((HttpException)ex).GetHttpCode() == 404){Response.Redirect("/Error/Rrror404");}}
}

注意事项： 在开发时候，我们经常会在Global.asax中的Application_Error方法中使用Response.Redirect方法跳转到自定义错误页，但有时候（特别是当站点部署到 IIS 后）Application_Error方法中使用Response.Redirect方法会失效，当发生异常错误后还是显示的默认错误黄页。

其根本原因是尽管我们在Application_Error方法中使用了Response.Redirect方法，但是当系统发生异常错误后Asp.Net认为异常并没有被处理，所以不会跳转到Application_Error方法中Response.Redirect指向的页面，最终还是会跳转到默认错误黄页。

解决这个问题的办法很简单就是在Application_Error方法中使用Response.Redirect做跳转前，先调用Server.ClearError()方法告诉系统发生的异常错误已经被处理了，这样再调用Response.Redirect方法系统就会跳转到自定义错误页面了。

增加代码后再次访问

http://localhost:58146/Error/Rrror404

3.4、如果是直接访问不存在的文件呢？它还是会报错的

http://localhost:58146/1.html

这个时间你需要看，第四节

四、访问不存在的静态资源，404错误问题解决

4.1、背景介绍

如我的站点下没有1.html这个文件，用户访问了，报错404

http://localhost:58146/1.html

4.2、【推荐】配置根目录的Web.config解决不存在文件的404错误问题

 我们需要在第三节代码基础上去修改【Web.config】

第三节代码如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration><system.web><compilation debug="true" targetFramework="4.5"/><httpRuntime targetFramework="4.5"/> <customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" /></customErrors></system.web><system.webServer><handlers><remove name="ExtensionlessUrlHandler-Integrated-4.0"/><remove name="OPTIONSVerbHandler"/><remove name="TRACEVerbHandler"/><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler"preCondition="integratedMode,runtimeVersionv4.0"/></handlers> </system.webServer>
</configuration>

在【system.webServer】节点增加代码

<httpErrors errorMode="Custom"><remove statusCode="404" subStatusCode="-1" /><error statusCode="404" prefixLanguageFilePath="" path="/Error/Rrror404" responseMode="ExecuteURL" />
</httpErrors>

完整代码

<?xml version="1.0" encoding="utf-8"?>
<configuration><system.web><compilation debug="true" targetFramework="4.5"/><httpRuntime targetFramework="4.5"/> <customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" /></customErrors></system.web><system.webServer><handlers><remove name="ExtensionlessUrlHandler-Integrated-4.0"/><remove name="OPTIONSVerbHandler"/><remove name="TRACEVerbHandler"/><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler"preCondition="integratedMode,runtimeVersionv4.0"/></handlers> <httpErrors errorMode="Custom"><remove statusCode="404" subStatusCode="-1" /><error statusCode="404" prefixLanguageFilePath="" path="/Error/Rrror404" responseMode="ExecuteURL" /></httpErrors></system.webServer>
</configuration>

详细节点说明请看第六节  

再次访问http://localhost:58146/1.html

4.3、【推荐】你也可以通过配置IIS的站点来设置这个错误页面

在IIS中找到你的站点，在【功能视图】中找到【错误页】

 双击进入，找到404配置项，点击后，在右侧有个“编辑”，点击“编辑”，弹出窗口，你就可以编辑它了；这个设置，和【4.2小节】修改【Web.config】效果基本一直。

五、完整修改【Web.config】后的代码

5.1、Web.config完整代码

<?xml version="1.0" encoding="utf-8"?>
<!--有关如何配置 ASP.NET 应用程序的详细信息，请访问https://go.microsoft.com/fwlink/?LinkId=301880
-->
<configuration><appSettings><add key="webpages:Version" value="3.0.0.0"/><add key="webpages:Enabled" value="false"/><add key="ClientValidationEnabled" value="true"/><add key="UnobtrusiveJavaScriptEnabled" value="true"/></appSettings><system.web><compilation debug="true" targetFramework="4.5"/><httpRuntime targetFramework="4.5"/><customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" /></customErrors></system.web><system.webServer><handlers><remove name="ExtensionlessUrlHandler-Integrated-4.0"/><remove name="OPTIONSVerbHandler"/><remove name="TRACEVerbHandler"/><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler"preCondition="integratedMode,runtimeVersionv4.0"/></handlers><httpErrors errorMode="Custom"><remove statusCode="404" subStatusCode="-1" /><error statusCode="404" prefixLanguageFilePath="" path="/Error/Rrror404" responseMode="ExecuteURL" /></httpErrors></system.webServer> 
</configuration>

5.2、重点代码1：对访问路径错误进行404处理

    <customErrors mode="On" defaultRedirect="/Error/Rrror404"><error statusCode="404" redirect="/Error/Rrror404" /></customErrors>

 注意：redirect="url"里面的url不要填文件地址，而是要填写请求404页面的控制器。

mode属性说明：
本地调试时，用RemoteOnly属性；发布时，用On

On：指定启用自定义错误。如果没有指定 defaultRedirect，用户将看到一般性错误。
Off：指定禁用自定义错误。这允许显示详细的错误。
RemoteOnly：指定仅向远程客户端端显示自定义错误，并向本地主机显示 ASP.NET 错误。这是默认值。 

5.3、重点代码2：对访问无效文件进行404处理

    <httpErrors errorMode="Custom"><remove statusCode="404" subStatusCode="-1" /><error statusCode="404" prefixLanguageFilePath="" path="/Error/Rrror404" responseMode="ExecuteURL" /></httpErrors>

详细节点说明请看第六节 

 六、Web.config配置节点介绍

本节点摘录

iis7设置404,使用web.config配置404,HTTP错误httpErrors模块-豫章小站

您可以<httpErrors>在ApplicationHost.config文件中的服务器级别以及相应Web.config文件中的站点和应用程序级别配置元素。

6.1、兼容性

版笔记
IIS 10.0<httpErrors>在IIS 10.0中未修改该元素。
IIS 8.5<httpErrors>IIS 8.5中未修改该元素。
IIS 8.0<httpErrors>在IIS 8.0中未修改该元素。
IIS 7.5该allowAbsolutePathsWhenDelegated属性已添加到<httpErrors>IIS 7.5中的元素
IIS 7.0该<httpErrors>元素是在IIS 7.0中引入的。
IIS 6.0该<httpErrors>元素替换了IIsWebService配置数据库对象的IIS 6.0 HttpErrors属性。

6.2、属性

属性描述
allowAbsolutePathsWhenDelegated可选的布尔属性。

设置为true时，<httpErrors>委派节时，允许自定义错误页面使用绝对路径。设置为false时，仅允许相对于站点根目录的路径。

默认值为false。

defaultPath可选字符串属性。

指定自定义错误页面的默认路径。路径类型由defaultResponseMode属性确定。如果选择“ 文件”，则返回文件路径。如果选择ExecuteURL或Redirect路径类型，则返回自定义错误页面的URL。

defaultResponseMode可选的枚举属性。

指定返回自定义错误内容的方式。

所述defaultResponseMode属性可以是以下可能的值中的一个; 默认是File。

值描述
File提供静态内容，例如，自定义错误的.html文件。如果responseMode设置为File，则路径值必须是文件路径。

数值是0。

ExecuteURL提供动态内容，例如，自定义错误的.asp文件。如果responseMode设置为ExecuteURL，则路径值必须是服务器相对URL。

数值是1。

Redirect将客户端浏览器重定向到包含自定义错误文件的其他URL。如果responseMode设置为Redirect，则路径值必须是绝对URL。

数值是2。

detailedMoreInformationLink可选字符串属性。

指定页面底部显示的链接，该链接包含有关特定错误的更详细信息的页面。您可以使用此属性将最终用户指向自定义位置以获取错误信息。状态，子状态，HRESULT和消息ID作为查询字符串的一部分发送。

默认值为HTTP status code overview - Internet Information Services | Microsoft Learn。

errorMode可选的枚举属性。

指定是否启用HTTP错误。

所述errorMode属性可以是以下值中的一个; 默认是DetailedLocalOnly。

值描述
DetailedLocalOnly如果请求来自本地计算机，则返回详细的错误信息，如果请求来自外部计算机，则返回自定义错误消息。

数值是0。

Custom用您指定的自定义页面替换模块或服务器生成的错误。此模式可用于向最终用户提供更友好的错误消息。

注意：此设置会关闭详细错误，即使对于本地请求也是如此。

数值是1。

Detailed将详细的错误信息发送回客户端。此模式对于测试和调试网站和应用程序非常有用。

数值是2。

existingResponse可选的枚举属性。

指定当HTTP状态代码是错误的，即响应代码> = 400会发生什么情况的现有响应

该existingResponse属性可以是以下值中的一个; 默认是Auto。

值描述
Auto仅在设置了SetStatus标志时才保持响应不变。

数值是0。

Replace即使设置了SetStatus标志，也会替换现有响应。

数值是1。

PassThrough如果存在现有响应，则保持响应不变。

数值是2。

子元素

元件描述
error可选元素。

向HTTP错误集合添加HTTP错误。

remove可选元素。

从HTTP错误集合中删除对HTTP错误的引用。

clear可选元素。

从HTTP错误集合中删除对HTTP错误的所有引用。

6.3、配置示例

以下配置示例（如果包含在Web站点或应用程序的Web.config文件中）使用errorMode属性仅允许在本地计算机上显示详细的错误消息。它还使用defaultResponseMode属性来设置站点或应用程序的响应模式。然后，该示例删除500状态代码的继承错误消息。接下来，它将prefixLanguageFilePath属性设置为IIS应搜索新自定义错误页面的目录，并将path属性设置为500.htm，即包含自定义错误消息的文件。

<configuration><system.webServer><httpErrors errorMode="DetailedLocalOnly" defaultResponseMode="File" ><remove statusCode="500" /><error statusCode="500"prefixLanguageFilePath="C:\Contoso\Content\errors"path="500.htm" /></httpErrors></system.webServer>
</configuration>

七、参考：

深入解析asp.net中mvc4自定义404页面（分享） - 双恒网络-免费PHP网站源码模板,插件软件资源分享平台！

iis7设置404,使用web.config配置404,HTTP错误httpErrors模块-豫章小站

web，mvc，ASP.NET设置404错误页面，c#_c# mvc自定义404-CSDN博客

相关文章：

  • 使用 Python 进行自然语言处理第 3 部分：使用 Python 进行文本预处理
  • C++ 菱形继承和虚拟菱形继承
  • C++引用详解
  • 在WebSocket中使用Redis出现空指针异常解决方案
  • Linux——如何使用sftp命令轻松上传和下载文件
  • HTTPS实现原理
  • 软件工程知识梳理2-需求分析
  • 离线使用Element UI和Vue
  • Spring Cloud Gateway
  • linux☞ Centos 基础篇
  • 【C++】构造函数和析构函数详解
  • python查询xml类别
  • 在JAVA中如何使用ASCLL码
  • go语言文件操作
  • 回归预测 | Matlab实现CPO-LSSVM冠豪猪算法优化最小二乘支持向量机多变量回归预测
  • 【108天】Java——《Head First Java》笔记（第1-4章）
  • 【笔记】你不知道的JS读书笔记——Promise
  • 【跃迁之路】【641天】程序员高效学习方法论探索系列（实验阶段398-2018.11.14）...
  • 5分钟即可掌握的前端高效利器：JavaScript 策略模式
  • JavaScript/HTML5图表开发工具JavaScript Charts v3.19.6发布【附下载】
  • Java小白进阶笔记(3)-初级面向对象
  • JS创建对象模式及其对象原型链探究（一）：Object模式
  • Python_OOP
  • Yeoman_Bower_Grunt
  • -- 查询加强-- 使用如何where子句进行筛选，% _ like的使用
  • 技术发展面试
  • 理解IaaS, PaaS, SaaS等云模型 (Cloud Models)
  • 前端攻城师
  • 前嗅ForeSpider教程：创建模板
  • 使用API自动生成工具优化前端工作流
  • 思否第一天
  • 用 vue 组件自定义 v-model， 实现一个 Tab 组件。
  • Nginx惊现漏洞 百万网站面临“拖库”风险
  • 我们雇佣了一只大猴子...
  • 新年再起“裁员潮”，“钢铁侠”马斯克要一举裁掉SpaceX 600余名员工 ...
  • ​io --- 处理流的核心工具​
  • ​LeetCode解法汇总2670. 找出不同元素数目差数组
  • ​低代码平台的核心价值与优势
  • #控制台大学课堂点名问题_课堂随机点名
  • #我与Java虚拟机的故事#连载17：我的Java技术水平有了一个本质的提升
  • (1/2) 为了理解 UWP 的启动流程，我从零开始创建了一个 UWP 程序
  • （11）MATLAB PCA+SVM 人脸识别
  • （3）llvm ir转换过程
  • (done) NLP “bag-of-words“ 方法 （带有二元分类和多元分类两个例子）词袋模型、BoW
  • （第一天）包装对象、作用域、创建对象
  • （动态规划）5. 最长回文子串 java解决
  • （附源码）springboot掌上博客系统 毕业设计063131
  • （没学懂，待填坑）【动态规划】数位动态规划
  • (使用vite搭建vue3项目（vite + vue3 + vue router + pinia + element plus）)
  • （四）Tiki-taka算法（TTA）求解无人机三维路径规划研究（MATLAB）
  • .CSS-hover 的解释
  • .gitignore
  • .NET I/O 学习笔记：对文件和目录进行解压缩操作
  • .vimrc php,修改home目录下的.vimrc文件，vim配置php高亮显示
  • /boot 内存空间不够