.NET 2.0升级到3.1后EF实体跟踪问题求助

问题描述 #

将.NET 2.0升级到3.1后，未修改任何代码，出现实体跟踪冲突错误：

The instance of entity type 'Table' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the conflicting key values.

已尝试以下方案但均无效：

• 使用AsNoTracking()：启用后EF会更新所有字段而非仅修改字段，且无法定位触发错误的代码段
• 手动设置实体状态为Modified：出现关联实体关系断裂错误：

The association between entity types 'Table' and 'RelationalTable' has been severed but the relationship is either marked as 'Required' or is implicitly required because the foreign key is not nullable. If the dependent/child entity should be deleted when a required relationship is severed, then setup the relationship to use cascade deletes.  Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the key values.

• 已在Startup.cs中配置Scoped生命周期的DbContext，单线程调试时仍报错

解决方法 #

1. 启用敏感日志定位冲突根源 #

先在Startup.cs中启用敏感数据日志，直接获取冲突实体的具体Id和跟踪来源，无需逐个排查代码：

services.AddDbContext<YourDbContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("YourConnectionString"))
           .EnableSensitiveDataLogging());

日志会输出重复跟踪的实体实例创建位置，精准定位问题代码。

2. 修复仓储中的重复跟踪逻辑 #

.NET Core 3.1的EF Core对实体跟踪的校验比2.0更严格，之前隐性的重复跟踪操作现在会触发错误：

• 检查仓储查询方法：如果需要查询同一主键实体并更新，避免重复查询；若必须多次查询，第二次查询使用AsNoTracking()，再将需要更新的字段映射到已跟踪的实体上，而非直接使用新实例。
• 避免盲目附加实体：在仓储的更新操作中，先检查实体是否已被当前DbContext跟踪，再处理状态：

var trackedEntity = _context.Set<Table>().Local.FirstOrDefault(e => e.Id == entity.Id);
if (trackedEntity != null)
{
    // 将修改后的字段值映射到已跟踪实体
    _context.Entry(trackedEntity).CurrentValues.SetValues(entity);
}
else
{
    _context.Attach(entity);
    _context.Entry(entity).State = EntityState.Modified;
}

3. 修复关联实体关系校验问题 #

第二个错误源于EF Core 3.1对必填外键关系的校验升级：

• 若RelationalTable的外键为必填项，确保更新Table时不会将关联的RelationalTable设为null；若需要在主实体更新时删除关联实体，在关系配置中启用级联删除：

modelBuilder.Entity<Table>()
    .HasMany(t => t.RelationalTables)
    .WithOne(rt => rt.Table)
    .OnDelete(DeleteBehavior.Cascade);

• 若不需要级联删除，将RelationalTable中的外键属性改为可空类型（如int?）。

4. 确认DbContext的生命周期使用 #

虽然配置了Scoped，但需确保仓储中的DbContext是通过构造函数注入的Scoped实例，没有手动创建全局DbContext对象，也没有在异步操作中错误共享DbContext实例。

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