EF Core 7新增带子集合的Bonus实体触发UPDATE而非INSERT异常

核心问题在于EF上下文错误地将子集合中的实体判定为已存在于数据库中的跟踪实体，因此尝试执行UPDATE而非INSERT，而这些子实体实际不存在于数据库，最终导致“预期影响1行，实际影响0行”的异常。以下是具体排查点和解决方法：

1. 子实体主键值异常 #

EF默认通过主键值判断实体状态：如果子实体（Currencies/Tiers）的主键被设置了非默认值（比如整数Id不为0、Guid不为Guid.Empty），EF会认为这是已存在的实体，自动生成UPDATE语句。

解决方法： #

确保新创建的子实体主键使用默认值，让EF识别为新增实体：

var newBonus = new Bonus
{
    // 其他Bonus属性赋值
    Currencies = new List<Currency>
    {
        new Currency { Id = 0, Code = "USD" } // 主键用默认值，由数据库或EF自动生成
    },
    Tiers = new List<Tier>
    {
        new Tier { Id = 0, Level = 1 }
    }
};

2. 上下文跟踪状态冲突 #

如果子实体之前被当前上下文加载过（比如之前执行过查询并被跟踪），即使你将其添加到新Bonus的集合中，EF仍会认为它是已存在的实体。

解决方法： #

• 若子实体是全新的，手动标记为新增状态：

var newBonus = new Bonus { /* 属性赋值 */ };
// 添加子实体后，手动设置状态
foreach (var currency in newBonus.Currencies)
{
    _context.Entry(currency).State = EntityState.Added;
}
foreach (var tier in newBonus.Tiers)
{
    _context.Entry(tier).State = EntityState.Added;
}
_context.Bonuses.Add(newBonus);
_context.SaveChanges();

• 若子实体来自外部数据（如DTO），确保创建全新的实体实例，而非复用上下文已跟踪的对象。

3. EF模型关系配置错误 #

错误的关联映射会导致EF无法正确识别子实体与新Bonus的从属关系，进而误判实体状态。

排查点： #

• 确认Bonus与Currencies/Tiers的关系为一对多，外键字段（如BonusId）定义在子实体上，且配置为可空（新增时EF会自动填充外键值）。
• 检查子实体主键的生成策略：若使用数据库自增，需配置DatabaseGeneratedOption.Identity，避免手动指定主键值导致EF误判。
• 避免将关系错误配置为多对多，或使用HasRequired强制要求外键非空（新增子实体时外键尚未赋值，会导致状态识别错误）。

举个正确的模型配置示例：

// Bonus实体配置
modelBuilder.Entity<Bonus>()
    .HasMany(b => b.Currencies)
    .WithOne(c => c.Bonus)
    .HasForeignKey(c => c.BonusId)
    .OnDelete(DeleteBehavior.Cascade);

// Currency实体配置
modelBuilder.Entity<Currency>()
    .Property(c => c.Id)
    .ValueGeneratedOnAdd(); // 主键自增，EF自动识别为新增

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