EF Core 8 DbContext多对多关系添加部分行报错，求排查原因

错误原因 #

报错信息显示INSERT statement conflicted with the FOREIGN KEY constraint "FK_ArticleTag_Tags_ArticleId"，核心问题出在实体类的多对多关系配置错误：

• 在Article类的Tags集合上添加了[ForeignKey("TagId")]，在Tag类的Articles集合上添加了[ForeignKey("ArticleId")]。这两个属性是错误的——ForeignKey仅用于一对多/一对一关系中指定外键字段，多对多关系的集合类型导航属性不需要该配置。
• EF Core 8自动生成中间表ArticleTag时，错误地将中间表的ArticleId字段关联到了Tags表的TagId外键（而非Articles表的ArticleId）。由于你的Tags表只有20条数据（最大TagId为20），当插入ArticleId大于20的关联记录时，数据库检查Tags表是否存在对应TagId的记录，自然找不到匹配项，触发外键冲突。

解决方案 #

移除两个实体类中集合导航属性上的错误ForeignKey配置，让EF Core正确识别多对多关系：

修改后的实体类代码 #

public class Article
{
    public Article()
    {
        Comments = new HashSet<Comment>();
        Tags = new HashSet<Tag>();
    }

    [Key]
    public int ArticleId { get; set; }
    public int? CategoryId { get; set; }

    [StringLength(30)]
    public string ArticleName { get; set; } = null!;
    public string? ArticleDescription { get; set; }
    public bool Visibility { get; set; }

    [ForeignKey("CategoryId")]
    [InverseProperty("Articles")]
    public virtual Category Category { get; set; }
    [InverseProperty("Article")]
    public virtual ICollection<Comment> Comments { get; set; }
    // 移除错误的[ForeignKey("TagId")]
    [InverseProperty("Articles")] 
    public virtual ICollection<Tag> Tags { get; set; }
}

public class Tag
{
    public Tag() 
    { 
        Articles = new HashSet<Article>();
    }

    [Key]
    public int TagId { get; set; }
    [Required]
    [StringLength(50)]
    public string Title { get; set; }

    // 移除错误的[ForeignKey("ArticleId")]
    [InverseProperty("Tags")]
    public virtual ICollection<Article>? Articles { get; set; }
}

后续操作 #

1. 重新生成迁移：执行Add-Migration FixManyToManyForeignKey（Package Manager Console）或dotnet ef migrations add FixManyToManyForeignKey（CLI）
2. 更新数据库：执行Update-Database（Package Manager Console）或dotnet ef database update（CLI）
3. 若不想重新生成迁移，可手动修改数据库：删除ArticleTag表的FK_ArticleTag_Tags_ArticleId约束，重新创建正确的外键——关联ArticleId到Articles.ArticleId，关联TagId到Tags.TagId

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