Entity Framework Core中仅保存PicnicBag与多对多关联表的方法

刚接触Entity Framework Core，遇到以下问题：
现有实体PicnicBag、Apple、Napkin，已通过add-migration和update-database命令生成对应数据表及多对多关联表PicnicBagApple。
规则说明：

• 一个PicnicBag可包含多个Apple，且仅能关联一个Napkin
• Apple和Napkin的数据是固定的，无需新增记录，仅需通过Swagger的POST接口创建PicnicBag并保存其关联关系

实体类代码：

public class Napkin 
{
    public int Id { get; set; }
    public string? NapkinColor { get; set; } 
}

public class Apple 
{
    public int Id { get; set; }
    public string AppleColor { get; set; }
    public virtual ICollection<PicnicBag> PicnicBags { get; set; }  
}

public class PicnicBag 
{
    public int Id { get; set; }
    public string PicnicBagColor { get; set; }
    public int PicnicBagSize { get; set; }
    
    public int NapkinId { get; set; }  // foreign key from Napkin to store related Id at PicnicBag table
    public Napkin Napkin { get; set; } // one to one
    
    public virtual ICollection<Apple> Apples { get; set; }  // many to many
}

已通过初始化类填充Apple和Napkin的数据：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    new DbInitalizer(modelBuilder).Seed();
}

尝试的CreatePicnicBag方法仅能插入PicnicBag表，无法写入PicnicBagApple关联表，尝试Detach操作时出现类型转换异常：

public PicnicBag CreatePicnicBag(PicnicBag picnicbag)
{
    // this part only inserts to PicnicBag but NOT to join table of PicnicBagApple table 
    // did not insert to Apple and Napkin that I wanted to have  (Ok)
    dbContext.PicnicBag.Attach(picnicbag);
    dbContext.Entry(picnicbag).State = EntityState.Added;
    dbContext.SaveChangesAsync();
    return picnicbag;
}

需求：仅保存PicnicBag表与PicnicBagApple关联表的内容，不修改Apple和Napkin表。

核心问题分析 #

你之前的代码将整个PicnicBag实体标记为Added状态时，EF Core会默认将其关联的所有实体（包括Apple和Napkin）也标记为Added，但你不需要新增这些已有数据，因此需要手动调整关联实体的状态，告诉EF Core这些实体是已存在的，只需要建立关联。

方法一：调整关联实体状态 #

如果接口传入的是完整的PicnicBag实体（包含关联的Apple对象），可以通过手动标记关联实体为Unchanged来实现：

public async Task<PicnicBag> CreatePicnicBag(PicnicBag picnicBag)
{
    // 将PicnicBag标记为新增状态
    dbContext.PicnicBags.Add(picnicBag);

    // 遍历关联的Apple，标记为已存在（Unchanged），避免EF尝试新增
    foreach (var apple in picnicBag.Apples)
    {
        dbContext.Entry(apple).State = EntityState.Unchanged;
    }

    // 处理Napkin：如果传入了Napkin对象，同样标记为Unchanged；若仅传NapkinId可省略此步
    if (picnicBag.Napkin != null)
    {
        dbContext.Entry(picnicBag.Napkin).State = EntityState.Unchanged;
    }

    // 异步保存更改（必须用await，否则可能未完成保存就返回）
    await dbContext.SaveChangesAsync();
    return picnicBag;
}

方法二：通过ID关联（更推荐） #

在接口中传递实体ID而非完整实体，不仅更高效，还能避免传递冗余数据，同时彻底杜绝EF误操作已有数据的可能：

1. 先定义一个DTO（数据传输对象）用于接收接口参数：

public class CreatePicnicBagDto
{
    public string PicnicBagColor { get; set; }
    public int PicnicBagSize { get; set; }
    public int NapkinId { get; set; }
    public List<int> AppleIds { get; set; }
}

2. 实现创建方法：

public async Task<PicnicBag> CreatePicnicBag(CreatePicnicBagDto dto)
{
    var picnicBag = new PicnicBag
    {
        PicnicBagColor = dto.PicnicBagColor,
        PicnicBagSize = dto.PicnicBagSize,
        NapkinId = dto.NapkinId,
        Apples = new List<Apple>()
    };

    // 为每个Apple ID创建仅含ID的实体并Attach，标记为已存在
    foreach (var appleId in dto.AppleIds)
    {
        var apple = new Apple { Id = appleId };
        dbContext.Apples.Attach(apple);
        picnicBag.Apples.Add(apple);
    }

    dbContext.PicnicBags.Add(picnicBag);
    await dbContext.SaveChangesAsync();
    return picnicBag;
}

关键注意事项 #

• 必须使用await调用SaveChangesAsync()，否则异步操作未完成就返回，可能导致数据未正确保存。
• 多对多关联表的写入依赖于EF Core对关联实体状态的识别：当主实体（PicnicBag）为Added，关联实体为Unchanged时，EF会自动插入关联表记录。

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