EF Core添加Invoice实体后触发外键循环/多级联路径错误

问题背景 #

定义了以下实体和DbContext：

User实体 #

public class User
{
    [Key]
    public string Username { get; set; }
}

Message实体 #

public class Message
{
    public int Id { get; set; }

    public string Text { get; set; }
    
    public DateTime Date { get; set; }
    
    public User Sender { get; set; }
    
    public User? Recipient { get; set; }
}

DummyContext #

public class DummyContext: DbContext
{
    public DummyContext(DbContextOptions<DummyContext> options)
        : base(options){ }

    public DbSet<Message> Messages { get; set; } = null!;

    public DbSet<User> Users { get; set; } = null!;
}

执行add-migration和update-database操作正常。之后添加Invoice实体并更新DbContext：

Invoice实体 #

public class Invoice
{
    public int Id { get; set; }

    public User Sender { get; set; }

    public User Recipient { get; set; }

    public string? Description { get; set; }

    public DateTime Date{ get; set; }

    public float Amount { get; set; }
}

更新后的DummyContext #

public class DummyContext: DbContext
{
    public DummyContext(DbContextOptions<DummyContext> options)
        : base(options){ }

    public DbSet<Message> Messages { get; set; } = null!;

    public DbSet<User> Users { get; set; } = null!;

    public DbSet<Invoice> Invoices{ get; set; } = null!;
}

再次执行迁移时出现错误：

The introduction of the FOREIGN KEY constraint 'FK_Invoices_Users_SenderUsername' in the 'Invoices' table can result in the creation of loops or more propagation paths. Specify ON DELETE NO ACTION or ON UPDATE NO ACTION or change the other FOREIGN KEY constraints.

需求：保持Message的级联删除生效，同时让Invoice在用户删除时也能级联删除，不设置OnDelete No Action。

原因解析 #

Message实体的Recipient是可空引用类型（User?），EF Core会自动为这个外键配置OnDelete(DeleteBehavior.NoAction)，因此Message表只有Sender外键是级联删除，不会产生多条传播路径冲突。

而Invoice的Sender和Recipient都是非空引用类型，EF Core默认会为两个外键都配置OnDelete(DeleteBehavior.Cascade)，这会导致数据库层面出现多条级联删除传播路径指向User表，数据库引擎不允许这种情况，因此抛出错误。

解决方案 #

使用Fluent API显式配置其中一个外键的删除行为为ClientCascade，让EF Core在客户端处理级联删除逻辑，而非依赖数据库层面的级联：

在DummyContext的OnModelCreating方法中添加配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 保持Message的默认级联行为不变（可省略，EF Core会自动处理）
    modelBuilder.Entity<Message>()
        .HasOne(m => m.Sender)
        .WithMany()
        .OnDelete(DeleteBehavior.Cascade);

    modelBuilder.Entity<Message>()
        .HasOne(m => m.Recipient)
        .WithMany()
        .OnDelete(DeleteBehavior.NoAction);

    // 配置Invoice的级联行为
    modelBuilder.Entity<Invoice>()
        .HasOne(i => i.Sender)
        .WithMany()
        .OnDelete(DeleteBehavior.Cascade); // 数据库层面级联删除

    modelBuilder.Entity<Invoice>()
        .HasOne(i => i.Recipient)
        .WithMany()
        .OnDelete(DeleteBehavior.ClientCascade); // 客户端层面级联删除
}

配置完成后，删除User时：

• 数据库会自动级联删除关联的Invoice（通过Sender外键）
• EF Core会在客户端加载关联的Invoice（通过Recipient外键）并删除它们
• Message的级联删除行为保持原有逻辑不变

重新执行add-migration和update-database即可完成迁移，满足需求。

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