EF Core软删除需实体含public bool IsDeleted属性并配HasQueryFilter，SaveChangesInterceptor拦截Deleted状态改为Modified并设IsDeleted=true，导航属性需单独过滤，硬删除须IgnoreQueryFilters()并手动处理关联。
GlobalFilter 软删除必须配合 IsDeleted 字段定义
EF Core 的全局查询过滤器（HasQueryFilter）本身不识别“软删除”语义，它只认你写的表达式。如果你在 OnModelCreating 里写 entity.HasQueryFilter(e => !e.IsDeleted)，那 EF 就真只按这个布尔值过滤——前提是实体类里**必须存在 IsDeleted 属性**，且类型为 bool（或可隐式转为 bool 的 nullable bool，但要小心 null 处理）。
常见错误是：字段名写成 Deleted、IsSoftDeleted 或加了 [NotMapped]，结果过滤器静默失效，查不到数据却无报错。
-
IsDeleted必须是 public get/set 属性，不能是字段 - 若用基类统一管理（如
BaseEntity），确保所有继承实体都映射该属性（EF 不会自动推导基类未声明的列） - 数据库迁移时，该字段需真实存在于表中；否则运行时查库报
Invalid column name 'IsDeleted'
SaveChanges 拦截器里自动设置 IsDeleted = true 而非 Delete()
调用 context.Remove(entity) 默认触发硬删除（DELETE SQL）。软删除要改行为：拦截 SaveChanges，把状态为 Deleted 的实体改为 Modified，并显式设 IsDeleted = true。
别直接重写 SaveChanges——容易漏掉异步版本或嵌套调用。推荐用 SaveChangesInterceptor：
public class SoftDeleteInterceptor : SaveChangesInterceptor
{
public override InterceptionResult<int> SavingChanges(
DbContextEventData eventData,
InterceptionResult<int> result)
{
if (eventData.Context is null) return base.SavingChanges(eventData, result);
foreach (var entry in eventData.Context.ChangeTracker.Entries())
{
if (entry.State == EntityState.Deleted &&
entry.Entity is ISoftDelete softDelete)
{
entry.State = EntityState.Modified;
softDelete.IsDeleted = true;
}
}
return base.SavingChanges(eventData, result);
}
}
注意：接口 ISoftDelete 需定义 bool IsDeleted { get; set; }，且所有软删实体都要实现它——这是类型安全的关键锚点。
Include 导航属性时 QueryFilter 不自动穿透
HasQueryFilter 只作用于主实体，不会递归过滤其关联的导航属性。比如 Order 有 OrderItems 导航，即使两者都有 IsDeleted，查 context.Orders.Include(o => o.OrderItems) 时，OrderItems 仍会返回已软删的记录。
解决方法只有两个：
- 对导航属性显式再加过滤：
.Include(o => o.OrderItems.Where(oi => !oi.IsDeleted))（EF Core 5+ 支持） - 或在关系配置中加
HasQueryFilter到从属实体（如modelBuilder.Entity<orderitem>().HasQueryFilter(oi => !oi.IsDeleted)</orderitem>）
后者更彻底，但要注意：如果某 OrderItem 被软删，而它所属的 Order 也被软删，EF Core 不会因主实体被过滤就跳过加载从属实体——两个过滤器独立生效。
硬删除需求必须绕过 QueryFilter 且手动清理关联
真要物理删除时，不能只删主表。比如管理员执行“永久删除订单”，得同时删掉 OrderItems、Logs 等关联软删表里的对应记录。此时必须临时禁用过滤器：
context.ChangeTracker.QueryTrackingBehavior = QueryTrackingBehavior.NoTracking; context.Orders.IgnoreQueryFilters().Where(o => o.Id == id).ExecuteDelete(); // EF Core 7+ // 再手动删关联项...
重点不是怎么关过滤器，而是关了之后——你得自己保证外键一致性。EF Core 不会帮你级联删软删表里的行。如果依赖数据库级联（ON DELETE CASCADE），那这些外键约束必须指向真实删除动作，而非软删字段更新。
真正麻烦的是混合场景：部分表硬删、部分表软删、还有些表根本没软删字段。这时候 IgnoreQueryFilters() 就像一把没刻度的刀——用错一格，数据就断连。
