ASP.NET核心:当前页面显示异常消息的全局处理

在ASP.NET Core中，处理全局异常并显示友好的异常消息是一个常见的需求。以下是实现这一功能的基础概念和相关步骤：

基础概念

中间件（Middleware）：ASP.NET Core使用中间件来处理HTTP请求和响应。中间件可以在请求管道中的不同阶段执行操作。
异常处理中间件：专门用于捕获和处理应用程序中的异常。
自定义错误页面：当发生异常时，可以重定向到一个自定义的错误页面，显示友好的错误消息。

实现步骤

1. 创建自定义错误页面

首先，创建一个视图来显示错误消息。例如，在Views/Shared文件夹下创建一个名为Error.cshtml的文件：

<!-- Views/Shared/Error.cshtml -->
<!DOCTYPE html>
<html>
<head>
    <title>Error</title>
</head>
<body>
    <h1>Oops! Something went wrong.</h1>
    <p>@ViewData["ErrorMessage"]</p>
</body>
</html>

2. 配置异常处理中间件

在Startup.cs文件中配置异常处理中间件。确保在Configure方法中添加以下代码：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

3. 处理异常并传递错误消息

在HomeController中添加一个Error方法来处理异常并传递错误消息：

public class HomeController : Controller
{
    public IActionResult Index()
    {
        return View();
    }

    [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
    public IActionResult Error(string errorMessage = null)
    {
        ViewData["ErrorMessage"] = errorMessage ?? "An unexpected error occurred.";
        return View();
    }
}

4. 捕获并传递异常消息

在Startup.cs的Configure方法中，使用UseExceptionHandler中间件捕获异常并传递错误消息：

app.UseExceptionHandler("/Home/Error/{statusCode?}");
app.UseStatusCodePagesWithReExecute("/Home/Error/{0}");

app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Exception ex)
    {
        context.Response.Redirect($"/Home/Error?errorMessage={ex.Message}");
    }
});