在开发ASP.NET Core应用程序时，异常处理是一个至关重要的环节。合理的异常处理不仅能够提升程序的健壮性，还能提供更好的用户体验。本文将详细介绍ASP.NET Core中的异常处理机制，包括中间件异常处理、全局异常处理、日志记录以及自定义错误页面等。
ASP.NET Core使用中间件管道处理HTTP请求。当请求在管道中传递时，如果某个中间件抛出异常，后续中间件将不会被执行。为了捕获和处理这些异常，可以在管道中配置一个专门的异常处理中间件。
示例代码如下：
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage(); // 开发环境下的异常页面
}
else
{
app.UseExceptionHandler("/Error"); // 生产环境下的自定义错误页面
app.UseHsts();
}
// 其他中间件配置
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
全局异常处理通常通过实现一个全局异常过滤器来实现。在ASP.NET Core中，可以通过继承ExceptionFilterAttribute类并重写OnException方法来创建一个全局异常过滤器。
示例代码如下：
public class GlobalExceptionFilter : ExceptionFilterAttribute
{
public override void OnException(ExceptionContext context)
{
// 日志记录
var logger = context.HttpContext.RequestServices.GetService>();
logger.LogError(context.Exception, "An unexpected error occurred.");
// 自定义错误响应
context.Result = new JsonResult(new { Error = "An unexpected error occurred." })
{
StatusCode = StatusCodes.Status500InternalServerError
};
// 阻止其他异常过滤器执行
context.ExceptionHandled = true;
}
}
然后在Startup.cs中注册这个全局异常过滤器：
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers(options =>
{
options.Filters.Add(new GlobalExceptionFilter());
});
// 其他服务配置
}
在异常处理过程中，日志记录是非常重要的一个环节。ASP.NET Core提供了内置的日志记录框架，可以通过依赖注入的方式使用ILogger接口来记录异常信息。
示例代码如下：
public class SomeService
{
private readonly ILogger _logger;
public SomeService(ILogger logger)
{
_logger = logger;
}
public void DoSomething()
{
try
{
// 业务逻辑
}
catch (Exception ex)
{
_logger.LogError(ex, "An error occurred in DoSomething.");
throw; // 重新抛出异常，以便其他中间件或过滤器处理
}
}
}
在生产环境中，通常需要向用户展示一个友好的错误页面，而不是直接显示异常的详细信息。ASP.NET Core允许通过配置自定义的错误页面来实现这一点。
在Startup.cs的Configure方法中，使用app.UseExceptionHandler("/Error")来指定自定义错误页面的路径。然后，创建一个对应的控制器和操作方法来处理错误请求。
public class ErrorController : Controller
{
[Route("/Error")]
public IActionResult Error()
{
// 获取错误详情（仅在开发环境中可用）
var error = HttpContext.Features.Get()?.Error;
// 返回自定义错误页面
return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier, Message = error?.Message });
}
}
ASP.NET Core提供了丰富的异常处理机制，包括中间件异常处理、全局异常处理、日志记录以及自定义错误页面等。通过合理配置这些机制，可以大大提升应用程序的健壮性和用户体验。