.NET 5 EF Fluent API配置带Discriminator表的OnDelete行为

问题根源 #

SQL Server数据库本身存在硬限制：同一张表不能同时存在两个开启ON DELETE CASCADE的外键指向不同的父表，否则会判定存在多路径级联风险，直接阻止外键创建。
你之前用TPT模式时，FolderRoleBinding、FileRoleBinding分属两张独立表，每张表只有一个级联外键，所以不会触发这个限制；切换到TPH单表模式后，两个外键都落在RoleBindings同一张表中，直接配置数据库级联删除必然报错。

实现思路 #

数据库层面关闭级联删除避开引擎限制，使用EF Core提供的客户端级联能力实现删除规则：

• 删除RoleBinding记录时，对关联的Folder/File无任何影响
• 删除被上下文跟踪的Folder/File时，EF Core自动加载并删除关联的RoleBinding记录

前置修正 #

原实体类中FolderRoleBindings的Folder导航属性只有get访问器，EF Core无法正常填充导航属性，先补全set访问器：

public class FolderRoleBindings : RoleBindings
{
    public Guid FolderId { get; set; }
    public virtual Folder Folder { get; set; }
}

正确Fluent API配置 #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置TPH单表映射
    modelBuilder.Entity<RoleBindings>(e =>
    {
        e.ToTable("RoleBindings", "dbo");
        e.HasKey(key => key.Id);
        // 配置鉴别器
        e.HasDiscriminator()
            .HasValue<FileRoleBindings>("File")
            .HasValue<FolderRoleBindings>("Folder");
    });

    // 配置Folder与FolderRoleBinding的关系
    modelBuilder.Entity<Folder>(e =>
    {
        e.HasMany(f => f.Roles)
            .WithOne(r => r.Folder)
            .HasForeignKey(r => r.FolderId)
            // 客户端级联：数据库层面不设级联，EF上下文跟踪时自动删除关联RoleBinding
            .OnDelete(DeleteBehavior.ClientCascade);
    });

    // 配置File与FileRoleBinding的关系
    modelBuilder.Entity<File>(e =>
    {
        e.HasMany(f => f.Roles)
            .WithOne(r => r.File)
            .HasForeignKey(r => r.FileId)
            .OnDelete(DeleteBehavior.ClientCascade);
    });
}

配置效果 #

• 生成的RoleBindings表结构完全符合预期：Id|Role|Discriminator|FolderId|FileId，两个外键在数据库层面为ON DELETE NO ACTION，不会触发多路径级联报错
• 删除被上下文跟踪的Folder/File时，关联的RoleBinding记录会被EF Core自动标记为删除，随SaveChanges一并提交
• 单独删除RoleBinding记录时，不会对关联的Folder/File产生任何影响

注意事项 #

• 客户端级联仅对被EF Core上下文跟踪的实体生效，如果使用无跟踪查询、直接执行原生SQL删除、仅附加父实体状态为删除而不加载关联数据的场景，EF Core无法自动删除关联RoleBinding，这类场景需要手动处理关联数据，或在数据库中配置删除触发器兜底
• 不要尝试在数据库层面同时给两个外键开启级联删除，该操作会被SQL Server直接拒绝，属于数据库引擎层面的硬限制，和EF Core配置无关
• TPH模式下EF Core会自动将FolderId、FileId设置为可空字段，不需要手动配置，因为非对应派生类型的记录这两个字段必然为null

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