ASP.NET Core Web API中间件无法捕获自定义异常问题咨询

我来帮你分析下这个问题，大概率是类型匹配问题导致的，结合你的代码来看，主要有这几个可能的原因和对应的解决办法：

1. 命名空间未引用或重复定义了CustomException #

这是最常见的触发原因：

• 你的CustomException类所在的命名空间没有被中间件类引用，导致中间件里写的CustomException和你抛出的不是同一个类型（CLR会把不同命名空间的同名类视为完全不同的类型）。
• 或者你的解决方案里有多个地方定义了CustomException类，导致抛出的实例和中间件要捕获的类型不匹配。

解决办法：

• 在中间件的代码文件顶部，添加自定义异常所在命名空间的引用：

  using YourProjectNamespace.Exceptions; // 替换成你实际的命名空间
  

• 全局搜索解决方案里的CustomException，确保只有一处定义。

2. 异常被上层代码包装成了其他类型 #

有时候，如果你在异步方法里抛出异常，或者异常被ASP.NET Core内置中间件、第三方库包装成了AggregateException这类包装型异常，中间件捕获到的就不是直接的CustomException，而是外层的包装异常。

验证&解决方法：
在中间件的catch(Exception ex)块里加几行调试代码，看看实际捕获的异常类型：

catch(Exception ex)
{
    // 打印异常类型和内部异常信息，方便排查
    Console.WriteLine($"捕获到的异常类型：{ex.GetType().FullName}");
    Console.WriteLine($"内部异常类型：{ex.InnerException?.GetType().FullName}");
    await HandleExceptionAsync(httpContext, ex);
}

如果发现是AggregateException，可以修改捕获逻辑优先处理内部异常：

catch(AggregateException ex)
{
    var targetEx = ex.InnerException ?? ex;
    if (targetEx is CustomException customEx)
    {
        await HandleExceptionAsync(httpContext, customEx);
    }
    else
    {
        await HandleExceptionAsync(httpContext, targetEx);
    }
}
catch(Exception ex)
{
    await HandleExceptionAsync(httpContext, ex);
}

3. 中间件注册顺序错误 #

ASP.NET Core中间件是按注册顺序执行的，如果你的ExceptionMiddleware注册在其他中间件之后，前面的中间件可能已经提前捕获并处理了异常，导致你的异常中间件没机会拦截到。

解决办法：
在Program.cs（或Startup.cs的Configure方法）里，确保ExceptionMiddleware是第一个被注册的中间件：

var builder = WebApplication.CreateBuilder(args);

// 先注册服务...

var app = builder.Build();

// 异常中间件必须放在最前面，才能捕获后续所有中间件的异常
app.UseMiddleware<ExceptionMiddleware>();

// 再注册其他业务中间件
app.UseRouting();
app.UseAuthorization();

app.MapControllers();

app.Run();

额外优化建议 #

你的HandleExceptionAsync方法里已经有判断异常类型的逻辑，其实可以简化中间件的捕获代码，避免重复分支：

public async Task InvokeAsync(HttpContext httpContext)
{
    try
    {
        await _next(httpContext);
    }
    catch(Exception ex)
    {
        await HandleExceptionAsync(httpContext, ex);
    }
}

这样不管是什么异常都统一进入处理逻辑，再在HandleExceptionAsync里区分CustomException和通用异常，代码更简洁，也能规避类型匹配导致的捕获问题。

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