EF Core为AspNetRole加QueryFilter遇层级根实体限制错误

这个错误的核心原因是你的自定义角色实体AspNetRole没有被DbContext注册为Identity的根角色实体，导致EF Core将原生的IdentityRole<int>视为实体层次结构的根，而你的AspNetRole被当作派生类——QueryFilter只能应用于层次结构的根实体，所以才会抛出这个错误。

下面是具体的解决步骤：

1. 修正DbContext的泛型参数 #

你当前的DbContext继承自IdentityDbContext<AspNetUser, IdentityRole<int>, int>，这里使用的是原生的IdentityRole<int>作为角色实体类型，而不是你自定义的AspNetRole。需要把泛型参数替换为你的自定义类：

public class AspNetSecurityDbContext : IdentityDbContext<AspNetUser, AspNetRole, int>
{
    public AspNetSecurityDbContext(DbContextOptions<AspNetSecurityDbContext> options) 
        : base(options) { }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        builder.ApplyConfiguration(new AspNetRoleMap());
    }
}

2. 调整QueryFilter的实现（可选：全局统一过滤） #

现在AspNetRole已经成为根实体，你原来的AspNetRoleMap中的QueryFilter可以正常工作了。如果想给所有实现IEntityBase的实体统一添加软删除过滤，可以在OnModelCreating中遍历所有实体类型，避免逐个配置：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);
    builder.ApplyConfiguration(new AspNetRoleMap());

    // 为所有实现IEntityBase的实体添加全局软删除过滤
    foreach (var entityType in builder.Model.GetEntityTypes())
    {
        if (typeof(IEntityBase).IsAssignableFrom(entityType.ClrType))
        {
            var parameter = Expression.Parameter(entityType.ClrType, "entity");
            var isDeletedProperty = Expression.Property(parameter, nameof(IEntityBase.IsDeleted));
            var filterExpression = Expression.Lambda(Expression.Not(isDeletedProperty), parameter);
            
            builder.Entity(entityType.ClrType).HasQueryFilter(filterExpression);
        }
    }
}

3. 验证其他Identity实体的一致性 #

确保你的自定义用户实体AspNetUser也正确继承了IdentityUser<int>，并且在DbContext中正确使用——你当前的代码已经做到了这一点，但如果后续有其他自定义Identity实体（比如AspNetRoleClaim等），也要遵循同样的规则：自定义类继承原生Identity类，然后更新DbContext的泛型参数（如果需要的话）。

完成这些修改后，重新生成迁移并执行，错误应该就会消失了。

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