Entity Framework Core批量保存时SaveChanges报错但数据已入库

问题场景 #

批量保存实体列表到数据库时触发以下异常，但数据实际已成功入库：

The property 'xxxxx' has a temporary value while attempting to change the entity's state to 'Unchanged'. Either set a permanent value explicitly, or ensure that the database is configured to generate values for this property.

异常堆栈信息：

at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry.SetEntityState(EntityState oldState, EntityState newState, Boolean acceptChanges, Boolean modifyProperties)    
at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry.SetEntityState(EntityState entityState, Boolean acceptAllChanges, Boolean modifyProperties, Nullable`1 forceStateWhenUnknownKey, Nullable`1 fallbackState)    
at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry.AcceptChanges()    
at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.StateManager.AcceptAllChanges(IReadOnlyList`1 changedEntries)     
at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.StateManager.SaveChanges(StateManager stateManager, Boolean acceptAllChangesOnSuccess) at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.StateManager.<>c.b__107_0(DbContext _, ValueTuple`2 t)    
at Microsoft.EntityFrameworkCore.Storage.ExecutionStrategy.<>c__DisplayClass28_0`2.b__0(DbContext context, TState state)    
at Microsoft.EntityFrameworkCore.Storage.ExecutionStrategy.ExecuteImplementation[TState,TResult](Func`3 operation, Func`3 verifySucceeded, TState state)     
at Microsoft.EntityFrameworkCore.Storage.ExecutionStrategy.Execute[TState,TResult](TState state, Func`3 operation, Func`3 verifySucceeded)    
at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.StateManager.SaveChanges(Boolean acceptAllChangesOnSuccess)     
at Microsoft.EntityFrameworkCore.DbContext.SaveChanges(Boolean acceptAllChangesOnSuccess)     
at Microsoft.EntityFrameworkCore.DbContext.SaveChanges().

单独逐个保存元素时无异常，但速度极慢。

原因分析及解决办法 #

1. 标识列配置错误 #

异常核心是EF Core认为xxxxx属性（通常是主键或自增列）的临时值未被替换为数据库生成的永久值：

• 若该字段为数据库自增列：确保实体配置中标记[DatabaseGenerated(DatabaseGeneratedOption.Identity)]，或用Fluent API配置：

  entity.Property(e => e.xxxxx).ValueGeneratedOnAdd();
  

• 若为手动赋值主键：批量保存前给每个实体的xxxxx属性设置唯一永久值，不要依赖EF临时值生成。

2. 批量状态跟踪异常 #

批量添加非EF创建的实体时，上下文可能未正确跟踪状态，导致保存后无法更新临时值：

• 使用DbContext.AddRange()替代循环Add()，确保EF正确批量处理状态；
• 若使用第三方批量库，检查是否兼容当前EF Core版本，部分库可能绕过EF状态跟踪逻辑引发问题。

3. 保存阶段状态处理问题 #

异常发生在AcceptChanges()阶段，说明数据库已写入，但EF更新实体状态失败：

• 尝试调用SaveChangesAsync(true)，强制EF在保存成功后接受所有状态变更；
• 临时 workaround：批量保存后手动将实体状态设为Unchanged，但建议优先从配置层面解决。

4. 关联实体未正确跟踪 #

若xxxxx是关联实体的外键，关联实体未被上下文跟踪也会引发临时值问题：

• 确保关联实体已被EF上下文跟踪（比如先查询关联实体），或直接设置外键的永久值，而非仅设置导航属性。

批量保存性能优化 #

解决单个保存速度慢的问题：

• 使用AddRange()批量添加，EF会生成单条多值INSERT语句，远快于循环Add()+SaveChanges()；
• 关闭不必要的跟踪：批量操作后调用ChangeTracker.Clear()释放资源，或查询时使用AsNoTracking()；
• 超大量数据场景可使用EF Core批量扩展（如EFCore.BulkExtensions）实现高性能批量插入。

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