ASP.NET Core全局异常中间件多层嵌套异常问题咨询

这种异常嵌套的问题我之前也碰到过，核心原因通常和异步代码的处理以及异常序列化逻辑有关，咱们一步步来解决：

你遇到的情况是两个环节叠加导致的：

• 异步操作未正确等待：如果DAL层的方法是异步实现（返回Task/Task<T>），但上层调用时没有用await等待任务完成，未处理的异常会被自动包装成AggregateException。
• 异常序列化失败：全局中间件尝试直接序列化整个异常对象时，Exception类的部分内部属性（比如嵌套引用、堆栈跟踪中的非序列化成员）无法被JSON序列化，进而抛出JsonSerializationException。

1. 修复异步代码的await问题 #

这是解决AggregateException嵌套的核心前提。确保所有异步方法调用都使用await等待任务完成，避免异常被包装。

错误示例（未使用await） #

// DAL层异步方法
public Task<Product> GetProductByIdAsync(int id)
{
    if (!ProductExists(id))
        throw new EntityNotFoundException($"Product {id} not found");
    return Task.FromResult(GetProductFromDb(id));
}

// 上层调用未await，异常会被包装成AggregateException
public IActionResult GetProduct(int id)
{
    var product = _productDal.GetProductByIdAsync(id);
    return Ok(product);
}

正确示例（使用await） #

public async Task<IActionResult> GetProduct(int id)
{
    // 用await等待异步任务，异常会直接抛出而非被包装
    var product = await _productDal.GetProductByIdAsync(id);
    return Ok(product);
}

2. 在全局中间件中解包异常并安全处理 #

即使不小心出现了嵌套异常，我们可以在中间件里递归解开包装，找到真正的自定义异常，同时避免直接序列化整个异常对象。

public async Task InvokeAsync(HttpContext context, RequestDelegate next)
{
    try
    {
        await next(context);
    }
    catch (Exception ex)
    {
        // 递归解开所有嵌套的包装异常
        var actualException = UnwrapNestedException(ex);
        
        // 针对性处理自定义异常
        if (actualException is EntityNotFoundException notFoundEx)
        {
            context.Response.StatusCode = StatusCodes.Status404NotFound;
            await context.Response.WriteAsJsonAsync(new 
            {
                Code = "ENTITY_NOT_FOUND",
                Message = notFoundEx.Message
            });
        }
        // 其他自定义异常的处理逻辑...
        else
        {
            // 处理未预期的异常
            context.Response.StatusCode = StatusCodes.Status500InternalServerError;
            await context.Response.WriteAsJsonAsync(new 
            {
                Code = "INTERNAL_ERROR",
                Message = "An unexpected error occurred"
            });
        }
    }
}

// 递归解开AggregateException、TargetInvocationException等包装异常
private Exception UnwrapNestedException(Exception ex)
{
    if (ex is AggregateException aggEx)
    {
        // 取第一个内部异常（你也可以根据需求处理多个内部异常）
        return UnwrapNestedException(aggEx.InnerException ?? aggEx);
    }
    else if (ex is TargetInvocationException targetEx)
    {
        return UnwrapNestedException(targetEx.InnerException ?? targetEx);
    }
    else if (ex.InnerException != null)
    {
        return UnwrapNestedException(ex.InnerException);
    }
    return ex;
}

3. 避免直接序列化Exception对象 #

永远不要直接返回Exception实例作为JSON响应——Exception包含大量无法序列化的内部状态（比如循环引用的InnerException、非公共成员）。应该只提取业务需要的信息（如错误码、消息）来构建响应。

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