EF Core基于可空属性的全局查询过滤器引发空引用异常

核心思路 #

直接在查询过滤器的表达式中处理AllowedTenants为null的情况，让EF Core在无需过滤时自动跳过租户匹配逻辑，避免空引用异常。

具体实现 #

假设你原本的过滤器配置是这样的（会在AllowedTenants为null时报错）：

modelBuilder.Entity<YourEntity>()
    .HasQueryFilter(e => AllowedTenants.Contains(e.TenantId));

修改为包含null判断的表达式：

modelBuilder.Entity<YourEntity>()
    .HasQueryFilter(e => AllowedTenants == null || AllowedTenants.Contains(e.TenantId));

这样当AllowedTenants为null时，表达式返回true，EF Core会跳过租户过滤，直接返回所有数据；当AllowedTenants非null时，正常执行租户匹配逻辑。

进阶：结合租户服务动态控制 #

如果你的租户信息是通过请求上下文动态获取的（比如从HttpContext或注入的服务），可以在DbContext中注入一个租户提供服务，确保过滤器能感知当前请求的租户状态：

1. 定义租户提供接口和实现：

public interface ITenantProvider
{
    IEnumerable<Guid>? AllowedTenants { get; set; }
}

public class TenantProvider : ITenantProvider
{
    public IEnumerable<Guid>? AllowedTenants { get; set; }
}

2. 在DbContext中注入该服务，并配置过滤器：

public class YourDbContext : DbContext
{
    private readonly ITenantProvider _tenantProvider;

    public YourDbContext(DbContextOptions<YourDbContext> options, ITenantProvider tenantProvider)
        : base(options)
    {
        _tenantProvider = tenantProvider;
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<YourEntity>()
            .HasQueryFilter(e => 
                _tenantProvider.AllowedTenants == null || 
                _tenantProvider.AllowedTenants.Contains(e.TenantId));
    }
}

3. 在请求处理时动态设置租户信息：

// 带租户信息的用户请求
tenantProvider.AllowedTenants = new List<Guid> { currentTenantId };

// 无租户信息的应用请求
tenantProvider.AllowedTenants = null;

注意事项 #

• 如果业务中存在AllowedTenants为空集合的场景，需要额外处理（比如返回空数据还是所有数据），可以在表达式中添加!AllowedTenants.Any()的判断分支。
• 确保EF Core能正确解析过滤器表达式，避免使用无法被翻译成SQL的复杂逻辑。

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