Entity Framework查询过滤器（QueryFilter）未作用于关联实体的解决方案咨询

你遇到的这个问题是EF Core全局查询过滤器的常见坑——默认情况下，过滤器的生效范围和实体加载方式、ChangeTracker的缓存状态密切相关。我来帮你拆解原因并给出可行的解决方案：

核心原因 #

EF Core的HasQueryFilter只作用于从数据库发起的查询，如果关联实体已经被加载到ChangeTracker中（比如之前查询过用户和标签），后续访问导航属性时会直接从缓存取数据，不会触发数据库查询，自然过滤器就不会生效。另外，如果你用的是延迟加载，导航属性的加载查询是否应用过滤器也取决于配置和追踪状态。

解决方案 #

1. 使用预先加载（Include）替代延迟加载 #

当你需要查询关联实体时，主动用Include来预先加载，这样EF会生成包含关联表的SQL查询，全局过滤器会自动应用到关联表的查询上：

// 正确写法：预先加载Tags，过滤器会生效
var userWithFilteredTags = _context.Users
    .Include(u => u.Tags)
    .FirstOrDefault(u => u.Id == user.Id);
// 此时userWithFilteredTags.Tags不会包含DeletedDate非null的标签

2. 避免ChangeTracker缓存干扰 #

你的测试用例中添加_context.ChangeTracker.Clear()后解决问题，本质是清除了之前追踪的实体缓存。如果不想每次都清空追踪器，可以使用AsNoTracking()来查询，这样EF不会缓存查询结果，每次都会从数据库取数据并应用过滤器：

var user = _context.Users
    .AsNoTracking()
    .Include(u => u.Tags)
    .FirstOrDefault(u => u.Id == user.Id);

3. 修正软删除的实现逻辑 #

你之前用_context.Tags.Remove(deletedUserTag)是标记实体为物理删除，这和软删除的逻辑冲突。正确的软删除应该是设置DeletedDate，而不是调用Remove。建议定义一个软删除接口统一处理：

public interface ISoftDelete
{
    DateTime? DeletedDate { get; set; }
}

// 让你的实体实现这个接口
public class Tag : ISoftDelete
{
    public int Id { get; set; }
    public DateTime? DeletedDate { get; set; }
    // 其他属性...
}

然后重写SaveChanges自动处理软删除，替代手动调用Remove：

public override int SaveChanges()
{
    var now = DateTime.UtcNow;
    foreach (var entry in ChangeTracker.Entries<ISoftDelete>())
    {
        if (entry.State == EntityState.Deleted)
        {
            // 把删除操作改为更新DeletedDate
            entry.State = EntityState.Modified;
            entry.Entity.DeletedDate = now;
        }
    }
    return base.SaveChanges();
}

这样你调用_context.Tags.Remove(deletedUserTag)时，EF会自动转为设置DeletedDate，而不是物理删除，后续查询时过滤器就能正确过滤这些实体。

4. 验证导航属性的关系配置 #

如果是多对多关系，确保中间表（如果显式定义了实体）也正确应用了过滤器，或者关系配置没有绕过过滤器。比如多对多的中间实体如果也有软删除字段，也要添加HasQueryFilter。

针对你的测试用例修正 #

你的测试用例最后一个断言失败，是因为之前用了Remove操作，导致实体被标记为物理删除，但ChangeTracker还缓存着旧的实体状态。按照上面的软删除逻辑修改后，测试用例应该改成：

public void SoftDeletedTagNotReturnedForUser() {
    // setup
    List<User> generatedUsers = SetupDatabaseUsersContent();
    // act
    var user = _context.Users.Include(u => u.Tags).FirstOrDefault();
    var deletedUserTag = user.Tags.FirstOrDefault();
    // 正确的软删除操作：设置DeletedDate
    deletedUserTag.DeletedDate = DateTime.UtcNow;
    _context.SaveChanges();
    _context.ChangeTracker.Clear(); // 清除缓存，确保后续查询从数据库取
    
    var tagWillBeNull = _context.Tags.FirstOrDefault(t => t.Id == deletedUserTag.Id);
    var allTagsForUserShouldNotHaveSoftDeleted = _context.Users
        .Include(u => u.Tags)
        .FirstOrDefault(u => u.Id == user.Id).Tags.ToList();
    // assert
    Assert.Null(tagWillBeNull); // 现在应该通过
    foreach(var tag in allTagsForUserShouldNotHaveSoftDeleted)
        Assert.Null(tag.DeletedDate); // 现在也会通过
}

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