EF Core代码优先重复引用同一表引发级联路径错误的解决方法

我用EF Core代码优先模式构建数据库，想要让ArticleWord表两次关联Word表，初始模型代码如下：

public class ArticleWord
{
    public long ID  { get; set; }
    public Article? Article { get; set; }
    public virtual Word Word { get; set; }
    public virtual Word WordTarget { get; set; }

    [ForeignKey(nameof(Word))]
    public long WordId { get; set; }

    [ForeignKey(nameof(WordTarget))]
    public long WordTargetId { get; set; }
}

迁移创建成功，但更新数据库时触发错误：

Failed executing DbCommand (107ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
CREATE TABLE [ArticleWords] (
    [ID] bigint NOT NULL IDENTITY,
    [ArticleID] bigint NULL,
    [WordId] bigint NOT NULL,
    [WordTargetId] bigint NOT NULL,
    [CreatedAt] datetime2 NOT NULL,
    [CreatedBy] nvarchar(max) NULL,
    [ModifiedAt] datetime2 NULL,
    [ModifiedBy] nvarchar(max) NULL,
    [IsDeleted] bit NOT NULL,
    CONSTRAINT [PK_ArticleWords] PRIMARY KEY ([ID]),
    CONSTRAINT [FK_ArticleWords_Articles_ArticleID] FOREIGN KEY ([ArticleID]) REFERENCES [Articles] ([ID]),
    CONSTRAINT [FK_ArticleWords_Words_WordId] FOREIGN KEY ([WordId]) REFERENCES [Words] ([ID]) ON DELETE CASCADE,
    CONSTRAINT [FK_ArticleWords_Words_WordTargetId] FOREIGN KEY ([WordTargetId]) REFERENCES [Words] ([ID]) ON DELETE CASCADE
);
Microsoft.Data.SqlClient.SqlException (0x80131904): Introducing FOREIGN KEY constraint 
'FK_ArticleWords_Words_WordTargetId' on table 'ArticleWords' may cause cycles or multiple cascade paths. 
Specify ON DELETE NO ACTION or ON UPDATE NO ACTION, or modify other FOREIGN KEY constraints.

我尝试修改模型（如下）但错误依然存在：

[Table("ArticleWords")]
public class ArticleWord : Table
{
    [JsonPropertyName("article")]
    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
    public Article? Article { get; set; }

    [JsonPropertyName("word")]
    public Word Word { get; set; }

    [JsonPropertyName("wordTarget")]
    public Word WordTarget { get; set; }
} 

另外，我添加WordId是为了方便在Lambda表达式中过滤数据，请问该如何修改代码实现两次关联Word表的需求？

错误根源是SQL Server不允许同一个表上存在多个指向同一父表的级联删除约束，这会导致可能的循环或多条级联路径冲突。需要通过Fluent API显式配置其中一个外键的删除行为为NoAction，同时保留方便过滤的外键属性。

步骤1：保留外键属性，确保模型完整性 #

先把模型改回包含外键属性的版本（这方便你用Lambda过滤）：

[Table("ArticleWords")]
public class ArticleWord : Table
{
    public long ID  { get; set; }
    
    [JsonPropertyName("article")]
    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
    public Article? Article { get; set; }
    public long? ArticleId { get; set; } // 显式添加Article的外键，可选但更清晰

    [JsonPropertyName("word")]
    public Word Word { get; set; }
    [ForeignKey(nameof(Word))]
    public long WordId { get; set; } // 保留此属性用于Lambda过滤

    [JsonPropertyName("wordTarget")]
    public Word WordTarget { get; set; }
    [ForeignKey(nameof(WordTarget))]
    public long WordTargetId { get; set; } // 保留此属性用于Lambda过滤
}

步骤2：用Fluent API配置外键行为 #

在DbContext的OnModelCreating方法中，显式配置两个Word外键的删除行为，将其中一个设置为NoAction（比如WordTargetId）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<ArticleWord>()
        .HasOne(aw => aw.Word)
        .WithMany() // 如果Word表没有反向导航属性，就用WithMany()
        .HasForeignKey(aw => aw.WordId)
        .OnDelete(DeleteBehavior.Cascade); // 保留其中一个级联删除

    modelBuilder.Entity<ArticleWord>()
        .HasOne(aw => aw.WordTarget)
        .WithMany()
        .HasForeignKey(aw => aw.WordTargetId)
        .OnDelete(DeleteBehavior.NoAction); // 另一个禁用级联删除，解决冲突

    // 如果Article和ArticleWord有反向导航，也可以补充配置，比如：
    // modelBuilder.Entity<ArticleWord>()
    //     .HasOne(aw => aw.Article)
    //     .WithMany(a => a.ArticleWords)
    //     .HasForeignKey(aw => aw.ArticleId)
    //     .OnDelete(DeleteBehavior.SetNull);
}

步骤3：重新生成迁移并更新数据库 #

执行以下命令：

Add-Migration FixArticleWordCascadeDelete
Update-Database

补充说明 #

• 如果Word表有指向ArticleWord的反向导航属性，需要在WithMany()中指定，比如WithMany(w => w.ArticleWordSources)和WithMany(w => w.ArticleWordTargets)，这样EF Core能正确识别关系。
• 选择哪一个外键禁用级联删除，取决于业务逻辑：如果删除Word时需要同步删除关联的ArticleWord，就保留该外键的Cascade；如果不需要，就设为NoAction或Restrict。

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