Entity Framework Core怎么实现软删除 EF Core全局查询过滤器用法

来源：这里教程网时间：2026-02-21 17:36:09 作者：

EF Core 实现软删除，核心是配合 全局查询过滤器（Global Query Filters） 自动对所有查询添加条件（如

IsDeleted == false

），同时在删除操作中不真正删数据，而是标记为已删除。关键在于配置一致、避免绕过、注意导航属性和显式加载的兼容性。

定义软删除接口和实体基类

统一管理软删除字段，便于复用和约束：

定义接口
ISoftDelete
，含
IsDeleted
和可选的
DeletedAt
属性让需要软删除的实体继承一个基类（如
BaseEntity
），实现该接口确保数据库字段对应（如
IsDeleted
类型为
bit
或
boolean
）

示例：

public interface ISoftDelete
{
  bool IsDeleted { get; set; }
  DateTime? DeletedAt { get; set; }
}

public abstract class BaseEntity : ISoftDelete
{
  public bool IsDeleted { get; set; }
  public DateTime? DeletedAt { get; set; }
}

在 DbContext 中配置全局查询过滤器

在

OnModelCreating

中为每个支持软删除的实体启用过滤器：

使用
modelBuilder.Entity<t>().HasQueryFilter(x => !x.IsDeleted)</t>
推荐用泛型方式批量注册，避免漏配；可用反射扫描继承自
BaseEntity
的类型过滤器会在所有 LINQ 查询（包括
Include
导航属性）中自动生效

示例（手动配置）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity().HasQueryFilter(u => !u.IsDeleted);
modelBuilder.Entity().HasQueryFilter(p => !p.IsDeleted);
}

重写 Delete 方法实现软删除逻辑

EF Core 默认调用

Remove()

会触发物理删除，需改为更新状态：

重写
SaveChanges
/
SaveChangesAsync
，扫描待删除实体，将其标记为
IsDeleted = true
，并取消物理删除操作将实体状态从
Deleted
改为
Modified
，仅更新软删除字段 注意：需排除已真正删除（如系统日志等不需要软删）的实体类型

示例片段：

public override int SaveChanges(bool acceptAllChangesOnSuccess)
{
  foreach (var entry in ChangeTracker.Entries())
  {
    if (entry.State == EntityState.Deleted)
    {
      entry.State = EntityState.Modified;
      entry.CurrentValues["IsDeleted"] = true;
      entry.CurrentValues["DeletedAt"] = DateTime.UtcNow;
    }
  }
  return base.SaveChanges(acceptAllChangesOnSuccess);
}