ASP.NET Core怎么实现全局异常处理 ASP.NET Core全局异常中间件

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

ASP.NET Core怎么实现全局异常处理 ASP.NET Core全局异常中间件

2025-12-12

浏览次数：次

返回列表

ASP.NET Core 全局异常处理最常用方式是使用 UseExceptionHandler 和 UseDeveloperExceptionPage 中间件；前者用于所有环境并支持自定义错误响应，后者仅开发环境启用以显示详细错误页；需按顺序注册，结合日志记录与类型判断实现差异化处理。

asp.net core怎么实现全局异常处理 asp.net core全局异常中间件

ASP.NET Core 实现全局异常处理，最常用且推荐的方式是使用内置的 异常处理中间件，比如 UseExceptionHandler 和 UseDeveloperExceptionPage。它们能捕获未被 try-catch 拦截的异常，并统一返回友好响应，避免堆栈信息暴露给生产环境用户。

配置全局异常处理中间件

在 Program.cs（.NET 6+）中，按顺序注册异常处理中间件：

UseDeveloperExceptionPage() 仅用于开发环境，显示详细错误页（含源码、变量、调用栈）
UseExceptionHandler() 用于所有环境，可指定自定义错误处理路径（如 /error）或内联委托处理异常

示例：

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
// ... 其他中间件

自定义错误处理页面或 API 响应

若使用 UseExceptionHandler("/Error")，需确保有对应端点（如 MVC 的 Error Action 或 Minimal API 路由）来接收并处理异常上下文：

微软爱写作

微软出品的免费英文写作/辅助/批改/评分工具

130

查看详情

MVC 中可在 Controllers/SharedController.cs 添加 Error 方法，通过 IHttpContextAccessor 或 HttpContext.Features.Get<iexceptionhandlerfeature>()</iexceptionhandlerfeature> 获取异常详情
API 场景下更推荐用内联委托直接返回 JSON 错误响应，例如：

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";

        var feature = context.Features.Get<IExceptionHandlerFeature>();
        var ex = feature?.Error;

        var response = new
        {
            error = "An unexpected error occurred.",
            detail = ex?.Message,
            traceId = context.TraceIdentifier
        };

        await context.Response.WriteAsJsonAsync(response);
    });
});