EF Core异常无法被ExceptionFilter捕获的问题求助

核心问题排查与修复 #

1. 过滤器未实现异步异常处理逻辑 #

如果你的CustomExceptionFilter仅重写了同步的OnException方法，但业务代码（如仓储、控制器）使用了异步操作（比如SaveChangesAsync），异步抛出的异常不会被同步过滤器捕获。必须同时实现IAsyncExceptionFilter接口的OnExceptionAsync方法：

public class CustomExceptionFilter : IExceptionFilter, IAsyncExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        ProcessException(context);
    }

    public Task OnExceptionAsync(ExceptionContext context)
    {
        ProcessException(context);
        return Task.CompletedTask;
    }

    private void ProcessException(ExceptionContext context)
    {
        // 自定义异常处理逻辑，示例返回统一错误响应
        context.Result = new ObjectResult(new 
        {
            Code = 500,
            Msg = "系统异常",
            Detail = context.Exception.Message
        })
        {
            StatusCode = StatusCodes.Status500InternalServerError
        };
        context.ExceptionHandled = true;
    }
}

2. 仓储层异步方法未正确传递异常 #

若仓储的InsertProduct方法未正确await异步操作，异常会被吞入后台线程，无法传递到过滤器：

错误写法

public void InsertProduct(Product product)
{
    _dbContext.Products.Add(product);
    _dbContext.SaveChangesAsync(); // 未await，异常无法向上抛出
}

正确写法

public async Task InsertProductAsync(Product product)
{
    _dbContext.Products.Add(product);
    await _dbContext.SaveChangesAsync(); // 必须await，让异常传递到上层
}

3. 过滤器注册方式错误 #

确保在ConfigureServices中正确注册过滤器，全局或控制器局部注册均可：

全局注册

services.AddControllers(options =>
{
    options.Filters.Add<CustomExceptionFilter>();
});

控制器局部注册

[TypeFilter(typeof(CustomExceptionFilter))]
public class ProductsController : ControllerBase
{
    // 控制器逻辑
}

4. 控制器方法未正确使用异步 #

如果控制器Post方法是同步的，但调用了异步仓储方法，同样会导致异常丢失：

错误写法

[HttpPost]
public IActionResult Post(Product product)
{
    _repository.InsertProductAsync(product); // 未await，异常在后台线程
    return Ok();
}

正确写法

[HttpPost]
public async Task<IActionResult> Post(Product product)
{
    await _repository.InsertProductAsync(product);
    return Ok();
}

5. DbContext拦截器吞掉异常 #

如果配置了SaveChangesInterceptor，确保拦截器未吞掉异常，需将异常重新抛出：

public class CustomSaveChangesInterceptor : SaveChangesInterceptor
{
    public override InterceptionResult<int> SavingChanges(DbContextEventData eventData, InterceptionResult<int> result)
    {
        // 自定义逻辑，不要吞异常
        return base.SavingChanges(eventData, result);
    }

    public override ValueTask<InterceptionResult<int>> SavingChangesAsync(DbContextEventData eventData, InterceptionResult<int> result, CancellationToken cancellationToken = default)
    {
        // 异步自定义逻辑，不要吞异常
        return base.SavingChangesAsync(eventData, result, cancellationToken);
    }
}

验证步骤 #

• 在SaveChangesAsync调用处手动抛出测试异常，确认过滤器是否能捕获，排除EF Core异常本身的特殊性问题。
• 检查ExceptionContext.ExceptionHandled是否被设置为true，确保过滤器已标记异常为已处理。
• 查看应用日志，确认EF Core的重复EAN异常确实被抛出，而非被其他逻辑静默处理。

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