ASP.NET Core 中文文档 第三章 原理(5)错误处理
原文:Error Handling
作者:Steve Smith
翻译:谢炀(Kiler)
校对:高嵩(jack2gs)、何镇汐
当你的ASP.NET应用发生错误的时候, 你可以采用本文所述的各种方法来处理这些问题。
配置错误处理页面
你在 Startup
类的 Configure()
方法中为每一个请求配置管道 (更多内容请参考 Application Startup)。 你可以轻松的添加一个仅仅适用于开发阶段的简单异常页面。只需要在项目中添加 Microsoft.AspNetCore.Diagnostics
依赖,并且添加一行代码到 Startup.cs
的 Configure()
方法里面:
public void Configure(IApplicationBuilder app, IHostingEnvironment env){app.UseIISPlatformHandler(); if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}
以上代码包含一个检查,以确保添加调用 UseDeveloperExceptionPage
的环境是开发环境。这是一个好的实践,因为你通常情况下并不希望在应用程序已经处于生产环境的情况下,将你的应用程序的详细异常信息对外公开. 详细了解如何配置环境。
示例应用程序包括一个创建异常的简单机制的例子:
public static void HomePage(IApplicationBuilder app){app.Run(async (context) =>{ if (context.Request.Query.ContainsKey("throw")){ throw new Exception("Exception triggered!");} var builder = new StringBuilder();builder.AppendLine("<html><body>Hello World!");builder.AppendLine("<ul>");builder.AppendLine("<li><a href=\"/?throw=true\">Throw Exception</a></li>");builder.AppendLine("<li><a href=\"/missingpage\">Missing Page</a></li>");builder.AppendLine("</ul>");builder.AppendLine("</body></html>");context.Response.ContentType = "text/html"; await context.Response.WriteAsync(builder.ToString());});
}
如果请求中包含一个变量名为 throw
的非空查询字符串 (例如,路径: /?throw=true
), 那么就会抛出一个异常。如果环境被设置为 Development
, 开发者异常页面将会被显示:
当不在开发模式下, 建议使用 UseExceptionHandler
方法来配置一个错误处理路径:
app.UseExceptionHandler("/Error");
使用开发者异常页面
当Web请求中发生无法捕获异常的时候,开发者异常页面会显示有用的调试信息。页面包含几个选项卡页面来显示Web请求中引发的异常信息。 第一个选项卡页面包含错误堆栈跟踪信息:
第二个选项卡页面显示查询字符串信息,如果有的话:
在这个案例里面,你可以看到 throw
参数的值被传递到了请求。这个请求不包含任何cookies,但是如果有任何cookies,他们的值会显示在cookies选项卡页面。你可以在最后一个选项卡页面查看到头信息:
配置状态码页面
在默认情况下,你的应用程序无法为Http状态码返回(例如:500 (服务器内部错误) or 404 (文件无法找到))提供一个富文本的HTTP状态码页面。你可以在 Configure
方法中加入一行 StatusCodePagesMiddleware
代码:
app.UseStatusCodePages();
在默认情况下,系统会为普通的http状态码添加一个非常简单纯文本的处理,例如,下面是404无法找到文件状态码返回的结果。
中间件提供不同的扩展方法,你也可以使用自定义lambda表达式来配置参数:
app.UseStatusCodePages(context =>context.HttpContext.Response.SendAsync("Handler, status code: " +context.HttpContext.Response.StatusCode, "text/plain"));
另外, 你也可以简单的传递一个内容类型和格式化字符串:
app.UseStatusCodePages("text/plain", "Response, status code: {0}");
中间件也能处理重定向请求 (无论是绝对路径还是相对路径), 把状态码作为URL的一部分进行传递:
app.UseStatusCodePagesWithRedirects("~/errors/{0}");
在上面的案例中, 客户端浏览器遇到 302 / Found
状态码返回时,会重定向到指定的页面.
另外,中间件也提供设置一个新的路径字符串的方式来重新执行请求。
app.UseStatusCodePagesWithReExecute("/errors/{0}");
方法 UseStatusCodePagesWithReExecute
会返回原始的浏览器状态码页面,但是也会执行路径中指定的处理程序。
如果你需要对某些请求禁止状态码页面, 可以使用以下代码:
var statusCodePagesFeature = context.Features.Get<IStatusCodePagesFeature>();if (statusCodePagesFeature != null)
{statusCodePagesFeature.Enabled = false;
}
错误处理在CS交互模式下的限制
Web应用在错误处理功能上因为断开HTTP请求和响应的特性有些特别的限制,有的应用程序,在你设计错误处理行为时请注意以下几点。
一旦响应文件头发送出去以后,你就无法再修改响应的状态码了,无论是任何异常页面或处理程序都无法执行。响应必须完成或者连接中断退出。
如果客户端在响应中期断开,你无法把当前响应的剩余内容发送给客户端。
在你的错误处理层之下,总是有可能存在有例外的一层。
不要忘了,错误处理页面也会产生异常. 生产环境异常页面采用纯静态页面是个不错的建议。
遵从上述建议将有助于确保您的应用程序保持响应,并且能很好地处理应用程序可能发生的异常。
服务器错误处理
除了你的应用程序中的错误处理逻辑,托管应用程序的服务器也将执行一些错误处理。如果服务器在头信息发送出去之前捕获到异常,它会发出不带主体的500内部服务器错误响应。如果在头文件发送出去之后捕获到异常必须关闭连接。那些不是被你的应用程序处理的请求将被服务器处理,并且发生的任何异常将被服务器的错误处理机制来处理。任何在你的应用程序里面配置好自定义错误页、错误处理中间件、过滤器都无法影响此行为。
Startup 错误处理
处理异常最为棘手的地方是在你的应用程序启动的时候。只有承载层可以处理应用程序的启动过程中发生的异常。应用程序启动时发生的异常也会影响服务器的行为。例如,要启用SSL in Kestrel,有些必须用 KestrelServerOptions.UseHttps()
配置服务器。如果一个异常在 Startup
代码行之前发生,则默认情况下托管将捕获异常,并启动服务器,然后在非SSL端口上显示一个错误页面。如果有异常情况发生在该行执行之后, 则错误页面将通过HTTPS服务生效。
ASP.NET MVC 错误处理
异常过滤器
异常过滤器可以在 MVC 应用程序的全局范围内或者每个Controller或者每个Action上进行配置。这些过滤器会处理controller action或其他过滤器的执行过程中发生的任何未处理的异常,其他情况则不会被调用。异常过滤器更多内容请见 过滤器。
小技巧
异常过滤器捕获MVC Action中发生的异常是很好的,但他们不如错误处理中间件灵活。一般情况下尽可能使用中间件,只有当在你需要在处理异常的时候需要特别指定某些MVC action的时候,过滤器才被建议使用。
处理模型状态错误
模型验证 在每个controller action被调用之前发生,Action方法的职责是检查 ModelState.IsValid
并作出适当的交互反应。在大部分情况下,特定的交互会返回特定的错误响应,最好详细说明模型验证失败的原因。
有些应用程序会选择遵循标准惯例处理模型验证错误,在这种情况下,过滤器可以作为某些策略的实现场所。您应该测试你的Action是否与有效和无效的模型状态有关联(了解更多有关 测试controller逻辑)的行为。
相关文章:
ASP.NET Core 中文文档 第一章 入门
ASP.NET Core 中文文档 第三章 原理(2)中间件
ASP.NET Core 中文文档 第三章 原理(3)静态文件处理
ASP.NET Core 中文文档 第三章 原理(4)路由
原文地址:http://www.cnblogs.com/dotNETCoreSG/p/aspnetcore-3_5-error-handling.html
.NET社区新闻,深度好文,微信中搜索dotNET跨平台或扫描二维码关注
ASP.NET Core 中文文档 第三章 原理(5)错误处理相关推荐
- ASP.NET Core 中文文档 第三章 原理(3)静态文件处理
原文:Working with Static Files 作者:Rick Anderson 翻译:刘怡(AlexLEWIS) 校对:谢炀(kiler398).许登洋(Seay).孟帅洋(书缘) 静态文 ...
- ASP.NET Core 中文文档 第三章 原理(13)管理应用程序状态
原文:Managing Application State 作者:Steve Smith 翻译:姚阿勇(Dr.Yao) 校对:高嵩 在 ASP.NET Core 中,有多种途径可以对应用程序的状态进行 ...
- ASP.NET Core 中文文档 第三章 原理(1)应用程序启动
原文:Application Startup 作者:Steve Smith 翻译:刘怡(AlexLEWIS) 校对:谢炀(kiler398).许登洋(Seay) ASP.NET Core 为你的应用程 ...
- ASP.NET Core 中文文档 第三章 原理(12)托管
原文:Hosting 作者:Steve Smith 翻译:娄宇(Lyrics) 校对:何镇汐.许登洋(Seay) 为了运行 ASP.NET Core 应用程序,你需要使用 WebHostBuilder ...
- ASP.NET Core 中文文档 第三章 原理(2)中间件
原文:Middleware 作者:Steve Smith and Rick Anderson 翻译:刘怡(AlexLEWIS) 校对:许登洋(Seay) 章节: 什么是中间件 用 IApplicati ...
- ASP.NET Core 中文文档 第四章 MVC(4.2)控制器操作的路由
原文:Routing to Controller Actions 作者:Ryan Nowak.Rick Anderson 翻译:娄宇(Lyrics) 校对:何镇汐.姚阿勇(Dr.Yao) ASP.NE ...
- ASP.NET Core 中文文档 第四章 MVC(3.9)视图组件
作者: Rick Anderson 翻译: 娄宇(Lyrics) 校对: 高嵩 章节: 介绍视图组件 创建视图组件 调用视图组件 演练:创建一个简单的视图组件 附加的资源 查看或下载示例代码 介绍视图 ...
- ASP.NET Core 中文文档 第四章 MVC(4.3)过滤器
原文:Filters 作者:Steve Smith 翻译:刘怡(AlexLEWIS) 校对:何镇汐 ASP.NET MVC 过滤器 可在执行管道的前后特定阶段执行代码.过滤器可以配置为全局有效.仅对控 ...
- ASP.NET Core 中文文档 第四章 MVC(2.2)模型验证
原文:Model Validation 作者:Rachel Appel 翻译:娄宇(Lyrics) 校对:孟帅洋(书缘) 在这篇文章中: 章节: 介绍模型验证 验证 Attribute 模型状态 处理 ...
最新文章
- gdb / 调试进入 so 库的方法
- 【H2 Database】查看帮助信息
- 怎么在mysql创建数据库怎么加入学号_数据库怎么创建学生信息表
- a标签点击跳转失效--IE6、7的奇葩bug
- Tomcat的starup.bat报错问题解决
- 软件测试培训班 软件测试0基础到项目实战
- 自动控制原理学习笔记(二)线性定常连续控制系统的数学模型
- DM8168 开机自动运行程序
- 数据分析实践——如何搭建数据指标体系(抖音为例)
- 微信小程序:语音变声器支持多种音效与流量主
- 建立自己的STM32项目库(库函数,Kile)
- 北京极简智能科技有限公司正式加入信创运维工作组
- STM32实现DAC功能输出音频波形
- 《论文阅读》Multi-Task Learning of Generation and Classification for Emotion-Aware Dialogue Response Gener
- 超好用的PDF阅读器——Xodo PDF Reader
- Pytest中测试用例参数化时ids中文乱码处理
- el-table 排序
- vue项目中引入mint-ui的方式(全部引入与按需引入)
- 【nepnepcat ctf】welcome_CAT_CTF
- 空间众包:现状与未来方向
热门文章
- (转)前置++和后置++的区别
- 电热水器和插座之间的相亲故事
- Protel中的快捷键使用(网上资源)
- TreeView控件应用--访问文件或文件夹(一)
- Android VNC Server New
- getopt()简介
- 使用C# 探索 ML.NET 中的不同机器学习任务
- 在 .NET Core 5 中集成 Create React app
- 【One by One系列】IdentityServer4(三)使用用户名和密码
- 如何在 C# 中使用 投影(Projection)