EF Core聚合根关联实体未持久化问题求助

核心问题原因 #

1. 缺失实体关系配置：未明确DataSheet与Category的一对多从属关系，EF无法识别新增Category属于哪个DataSheet，也无法自动处理子实体的状态流转。
2. 错误使用UpdateAsync：聚合根从数据库查询后已被EF上下文跟踪，调用UpdateAsync会强制将其状态设为Modified，但聚合根本身无标量属性变更，EF执行UPDATE语句时因影响行数为0触发乐观并发验证错误。

解决方案 #

1. 补充实体关系映射配置 #

在DataSheetConfiguration中添加一对多关系的配置，通过阴影属性定义外键（符合DDD聚合根设计，避免子实体暴露外键属性）：

public class DataSheetConfiguration: IEntityTypeConfiguration<DataSheet>
{
    public void Configure(EntityTypeBuilder<DataSheet> builder)
    {
        builder.HasKey(b => b.Id);
       
        // 配置DataSheet与Category的一对多从属关系
        builder.HasMany(ds => ds.Categories)
               .WithOne() // Category无反向导航属性，使用空的WithOne()
               .HasForeignKey("DataSheetId") // 定义阴影外键字段
               .OnDelete(DeleteBehavior.Cascade); // 聚合根删除时级联删除子实体

        // 确保EF使用私有后备字段访问导航属性
        var categoryNavigation = builder.Metadata.FindNavigation(nameof(DataSheet.Categories));
        categoryNavigation.SetPropertyAccessMode(PropertyAccessMode.Field);
    }
}

2. 修正保存逻辑，移除不必要的UpdateAsync #

由于查询出的DataSheet已被上下文跟踪，新增Category后直接调用SaveChangesAsync即可，EF会自动检测到集合变更并将新增的Category标记为Added：

// 1. 查询已跟踪的DataSheet（需包含Categories导航属性）
var dataSheet = await _dataContext.DataSheets
    .Include(ds => ds.Categories)
    .FirstOrDefaultAsync(ds => ds.Id == targetId);

// 2. 通过聚合根方法新增分类
dataSheet.CreateCategory("新分类名称");

// 3. 直接保存，无需调用UpdateAsync
await _dataContext.SaveChangesAsync();

3. 关键说明 #

• 变更检测机制：EF Core会监控私有后备字段_categories的集合操作（Add/Remove），只要实体处于跟踪状态，新增的Category会被自动标记为Added，无需手动设置状态。
• 乐观并发错误：UpdateAsync会强制将实体状态设为Modified，若聚合根本身无标量属性变更，EF生成的UPDATE语句不会修改任何行，触发"expected 1 row to be affected but 0 were affected"错误，因此仅在实体脱离跟踪时才需要使用UpdateAsync。

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