ASP.NET Core是一个高性能、开源的框架，广泛用于构建现代Web应用程序。在开发过程中，异常处理是保证应用程序健壮性和用户体验的关键环节。本文将详细介绍ASP.NET Core中的异常处理机制，涵盖中间件异常处理、全局异常处理、错误页面定制以及日志记录等方面。
ASP.NET Core请求管道由一系列中间件组成，每个中间件负责处理请求的不同部分。在请求处理过程中，如果发生异常，可以通过中间件进行捕获和处理。
可以使用`ExceptionHandlerMiddleware`中间件来捕获并处理异常。以下是一个示例：
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Error");
// 也可以设置自定义的错误处理路径
// app.UseExceptionHandler(errorApp =>
// {
// errorApp.Run(async context =>
// {
// context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;
// context.Response.ContentType = "text/html";
// await context.Response.WriteAsync("");
// });
// });
}
// 其他中间件配置
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
在ASP.NET Core中，可以通过全局异常过滤器（ExceptionFilter）来捕获和处理控制器中的异常。异常过滤器实现了`IExceptionFilter`接口，并在`OnException`方法中处理异常。
public class GlobalExceptionFilter : IExceptionFilter
{
public void OnException(ExceptionContext context)
{
// 日志记录
// _logger.LogError(context.Exception, "全局异常过滤器捕获到异常");
// 处理异常（例如返回自定义的错误信息）
context.Result = new JsonResult(new { error = "An unexpected error occurred." })
{
StatusCode = (int)HttpStatusCode.InternalServerError
};
// 阻止异常继续传播
context.ExceptionHandled = true;
}
}
// 在Startup.cs中注册全局异常过滤器
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers(options =>
{
options.Filters.Add(new GlobalExceptionFilter());
});
}
ASP.NET Core允许开发者自定义错误页面，以提供更加友好的用户体验。在开发环境中，可以使用`UseDeveloperExceptionPage`中间件来显示详细的异常信息。在生产环境中，可以配置自定义的错误页面。
创建一个`ErrorController`来处理自定义的错误页面：
public class ErrorController : Controller
{
[Route("/Error")]
[ApiExplorerSettings(IgnoreApi = true)]
public IActionResult Error()
{
var exceptionDetails = HttpContext.Features.Get();
var errorMessage = exceptionDetails?.Error.Message ?? "An unexpected error occurred.";
// 可以根据错误类型返回不同的响应
if (exceptionDetails?.Error is SomeSpecificException)
{
return BadRequest(new { error = errorMessage });
}
return StatusCode((int)HttpStatusCode.InternalServerError, new { error = errorMessage });
}
}
在处理异常时，日志记录是不可或缺的环节。ASP.NET Core提供了强大的日志记录框架，支持多种日志记录提供者（如Console、File、Serilog等）。
在`Program.cs`或`Startup.cs`中配置日志记录：
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup()
.ConfigureLogging(logging =>
{
logging.ClearProviders();
logging.AddConfiguration(Configuration.GetSection("Logging"));
logging.AddConsole();
// 添加其他日志提供者，如logging.AddFile()
});
});
}
ASP.NET Core提供了丰富的异常处理机制，包括中间件异常处理、全局异常处理、错误页面定制以及日志记录。这些机制可以帮助开发者构建更加健壮和友好的Web应用程序。通过合理配置和使用这些机制，可以显著提高应用程序的稳定性和用户体验。