如何跳过Entity Framework已捕获异常的日志记录

针对你遇到的EF Core在SaveChanges抛出异常前自动记录日志，而你希望已捕获的异常自行管理日志、未捕获异常保留EF默认日志的需求，无需禁用所有EF日志或修改全局日志配置，可以通过自定义EF拦截器实现精准控制：

步骤1：自定义SaveChanges失败拦截器 #

创建拦截器来判断异常类型，决定是否抑制EF的默认日志输出：

public class CustomSaveChangesInterceptor : SaveChangesFailedInterceptor
{
    public override InterceptionResult<int> SaveChangesFailed(
        DbContextErrorEventData eventData, 
        InterceptionResult<int> result)
    {
        // 匹配你要自行处理的异常类型，返回Suppress来阻止EF输出默认日志
        return ShouldSuppressLogging(eventData.Exception) 
            ? InterceptionResult<int>.Suppress() 
            : base.SaveChangesFailed(eventData, result);
    }

    public override ValueTask<InterceptionResult<int>> SaveChangesFailedAsync(
        DbContextErrorEventData eventData, 
        InterceptionResult<int> result, 
        CancellationToken cancellationToken = default)
    {
        return ShouldSuppressLogging(eventData.Exception) 
            ? new ValueTask<InterceptionResult<int>>(InterceptionResult<int>.Suppress()) 
            : base.SaveChangesFailedAsync(eventData, result, cancellationToken);
    }

    private bool ShouldSuppressLogging(Exception exception)
    {
        return exception switch
        {
            InvalidOperationException => true,
            DbUpdateConcurrencyException => true,
            DbUpdateException dbEx when 
                dbEx.InnerException is PostgresException pe && pe.SqlState == "23505" => true,
            _ => false
        };
    }
}

步骤2：注册拦截器到DbContext #

在依赖注入配置中，将自定义拦截器添加到DbContext的选项里：

services.AddDbContext<YourDbContext>(options =>
{
    options.UseNpgsql("你的数据库连接字符串")
           .AddInterceptors(new CustomSaveChangesInterceptor());
});

步骤3：在业务代码中自行处理已捕获异常的日志 #

保留原有的try-catch逻辑，在HandleException前按需添加自定义日志记录：

try
{
    using var c = contextFactory.CreateDbContext();
    c.Entities.AddRange(entities);
    c.SaveChanges();
}
catch (Exception e)
{
    switch (e)
    {
        case InvalidOperationException:
        case DbUpdateConcurrencyException:
        case DbUpdateException when (
            e.InnerException is PostgresException pe &&
            pe.SqlState == "23505"):
            // 这里根据需求自定义日志内容
            _logger.LogError(e, "处理已知异常：{ExceptionMessage}", e.Message);
            HandleException();
            break;

        default: throw;
    }
}

效果说明 #

• 当捕获到你指定的异常类型时，EF的默认错误日志（如Failed executing DbCommand、An exception occurred in the database）会被拦截器抑制，由你自行控制日志输出
• 未捕获的异常会正常触发EF的默认日志行为，无需额外配置

内容的提问来源于stack exchange，提问作者Dr. Strangelove