.NET自定义全局异常中间件无法捕获异常问题排查

你的自定义全局异常中间件未触发的核心原因是中间件注册顺序错误，同时UseExceptionHandler会抢先拦截异常导致自定义中间件无法捕获。

具体问题点 #

1. 中间件执行顺序逻辑误解：ASP.NET Core中间件遵循“请求按注册顺序进入，响应按注册顺序反向返回”的规则。异常会沿响应流程向上冒泡，被第一个能处理它的中间件捕获。你将UseExceptionHandler注册在自定义中间件之后，导致控制器抛出的异常先被UseExceptionHandler拦截处理，自定义中间件的catch块完全没机会触发。
2. 异常类型判断灵活性不足：用exceptionType == typeof(InvalidOperationException)的方式无法捕获该异常的子类，限制了异常处理的覆盖范围。

修复步骤 #

1. 调整中间件注册顺序（核心修复） #

方案一：移除UseExceptionHandler（推荐）

如果完全依赖自定义中间件处理异常，直接移除UseExceptionHandler，并确保自定义中间件注册在所有中间件最前面：

var app = builder.Build();

// 自定义异常中间件放在最靠前位置，确保捕获所有后续中间件的异常
app.AddGlobalErrorHandler();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseRouting();
app.UseCors(MyAllowSpecificOrigins);
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();

app.Run();

方案二：保留UseExceptionHandler作为兜底

若需要UseExceptionHandler处理自定义中间件未覆盖的异常，调整注册顺序，让自定义中间件在UseExceptionHandler之后（响应时优先捕获异常）：

var app = builder.Build();

// UseExceptionHandler先注册，作为兜底处理
app.UseExceptionHandler("/error");
// 自定义中间件后注册，优先捕获并处理异常
app.AddGlobalErrorHandler();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseRouting();
app.UseCors(MyAllowSpecificOrigins);
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();

app.Run();

2. 优化异常类型判断逻辑 #

改用is关键字判断异常类型，支持捕获子类异常：

private static Task HandleExceptionAsync(HttpContext context, Exception exception)
{
    HttpStatusCode status;

    if (exception is InvalidOperationException)
    {
        status = HttpStatusCode.NotFound;
    }
    else if (exception is PasswordIncorrectException)
    {
        status = HttpStatusCode.Unauthorized;
    }
    else
    {
        status = HttpStatusCode.InternalServerError;
    }

    var exceptionResult = JsonSerializer.Serialize(new { error = exception.Message, exception.StackTrace });
    context.Response.ContentType = "application/json";
    context.Response.StatusCode = (int)status;

    return context.Response.WriteAsync(exceptionResult);
}

3. 额外注意事项 #

• 确保自定义异常PasswordIncorrectException已正确定义并在项目中引用；
• 开发环境中若默认异常页面干扰测试，可修改appsettings.Development.json关闭详细错误页面：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "DetailedErrors": false
}

内容的提问来源于stack exchange，提问作者Pablo52