EF Core多对多关联外键触发循环或多重级联路径报错如何解决

需求背景 #

需要创建Author实体，该实体与Country实体存在两类关联：

• 一对一关联：存储作者的出生地CountryOfOrigin
• 多对多关联：存储作者到访过的国家集合

初始实体代码如下：

public class Author
{
    [Key]
    public int Id { get; set; }

    [Required]
    public string Name { get; set; }

    public int CountryOfOriginId { get; set; }

    [ForeignKey("CountryOfOriginId")]
    public Country CountryOfOrigin { get; set; }

    public ICollection<AuthorCountry> VisitedCountries { get; set; }
}

public class Country
{
    [Key]
    public int Id { get; set; }
    public string Name { get; set; }
}

public class AuthorCountry
{
    public int AuthorId { get; set; }
    [ForeignKey("AuthorId")]
    public Author Author { get; set; }

    public int CountryId { get; set; }
    [ForeignKey("CountryId")]
    public Country Country { get; set; }
}

多对多中间表AuthorCountry的联合主键配置如下：

modelBuilder.Entity<AuthorCountry>()
    .HasKey(c => new
    {
        c.CountryId,
        c.AuthorId
    });

报错信息 #

可以成功生成迁移文件，但执行更新数据库操作时抛出以下错误：

执行DbCommand失败（23ms）[参数=[], 命令类型='文本', 命令超时='30']
CREATE TABLE [AuthorCountry] (
    [AuthorId] int NOT NULL,
    [CountryId] int NOT NULL,
    CONSTRAINT [PK_AuthorCountry] PRIMARY KEY ([CountryId], [AuthorId]),
    CONSTRAINT [FK_AuthorCountry_Author_AuthorId] FOREIGN KEY ([AuthorId]) REFERENCES [Author] ([Id]) ON DELETE CASCADE,
    CONSTRAINT [FK_AuthorCountry_Countries_CountryId] FOREIGN KEY ([CountryId]) REFERENCES [Countries] ([Id]) ON DELETE CASCADE
);
Microsoft.Data.SqlClient.SqlException (0x80131904)：
为表AuthorCountry引入外键约束'FK_AuthorCountry_Countries_CountryId'可能会导致循环或多重级联路径。
请指定ON DELETE NO ACTION或ON UPDATE NO ACTION，或修改其他外键约束。

SQL Server不允许存在多条级联删除路径指向同一张表。本场景中删除Country记录时，会触发两个级联删除路径：

1. 通过Author表的CountryOfOriginId外键，级联删除关联的Author记录
2. 通过中间表AuthorCountry的CountryId外键，级联删除关联的中间表记录
   两条路径都涉及到和Author相关的删除操作，触发了数据库的级联路径限制。

调整关联的删除行为，关闭中间表到Country外键的级联删除即可。

1. 调整AuthorCountry实体，将Country的外键配置交由Fluent API处理：

public class AuthorCountry
{
    public int AuthorId { get; set; }
    public Author Author { get; set; }

    public int CountryId { get; set; }
    // 移除原有ForeignKey特性，改为Fluent API配置
    public Country Country { get; set; }
}

2. 添加Fluent API配置，指定删除行为为Restrict：

modelBuilder.Entity<AuthorCountry>()
    .HasOne(a => a.Country)
    .WithMany()
    .HasForeignKey(a => a.CountryId)
    .OnDelete(DeleteBehavior.Restrict);

配置完成后重新生成迁移并更新数据库即可正常执行。

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