Entity Framework Core单次插入带自增主键嵌套对象的方案问询

可行方案1：利用EF Core内置导航属性机制，单次SaveChanges完成全层级插入 #

EF Core原生支持完整对象图的插入操作，只要你正确配置了实体间的导航关联，不需要手动逐层插入、获取主键再赋值外键，框架会自动处理所有自增主键和外键的映射逻辑。

首先按如下方式配置实体类：

public class Analysis
{
    // 对应表自增主键
    public long AnalysisId { get; set; }
    public Guid? AnalysisGuid { get; set; }
    public DateTime Date { get; set; }
    // 一对多导航属性，关联所有子Scenario
    public ICollection<Scenario> Scenarios { get; set; } = new List<Scenario>();
}

public class Scenario
{
    // 对应表自增主键
    public long ScenarioId { get; set; }
    // 关联Analysis的外键
    public long AnalysisId { get; set; }
    public Guid? ScenarioGuid { get; set; }
    public int? HVACNumber { get; set; }
    // 反向导航属性
    public Analysis Analysis { get; set; }
    // 若Scenario下还有更低层级的嵌套对象，按同样规则添加导航属性即可
    // public ICollection<SubObject> SubObjects { get; set; } = new List<SubObject>();
}

插入逻辑仅需3行代码：

// analysis为API传入的完整嵌套对象，已填充所有层级的子对象
var analysis = 接口传入的Analysis实例;
// 直接将顶层对象加入上下文
dbContext.Analyses.Add(analysis);
// 单次提交即可完成全层级插入
await dbContext.SaveChangesAsync();

原理说明：提交时EF Core会自动按依赖顺序生成SQL，先插入Analysis获取生成的自增主键，自动将主键值赋值到所有关联Scenario的AnalysisId字段，再插入Scenario对象，同理递归处理更低层级的嵌套对象，所有操作在同一个事务内完成，性能远高于逐层调用SaveChanges的方案，可满足绝大多数中低量级的插入需求。

可行方案2：使用EF Core批量扩展工具，超大数据量下性能更优 #

如果单次插入数据量超过1万条，对插入速度要求极高，可以使用EF生态中成熟的批量插入扩展库，开启嵌套对象插入支持后，插入性能比原生方案高3~10倍，示例代码如下：

// 传入完整嵌套的Analysis对象，开启图插入支持即可
await dbContext.BulkInsertAsync(analysis, options => 
{
    options.IncludeGraph = true;
});

性能优化建议 #

• 插入前可临时关闭上下文自动跟踪，进一步提升效率：dbContext.ChangeTracker.AutoDetectChangesEnabled = false;，插入完成后恢复属性值即可
• 确保实体的关联关系和外键配置正确，避免EF Core自动映射出错
• 单批次插入数据量建议控制在10万条以内，超过的话建议拆分批次插入，避免单次事务过大影响数据库性能

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