EF Core插入含已有导航属性的新实体失败问题求助

问题场景 #

需要导入大文件，批量创建大量Module及其关联的Product（一对多关系），同时将数据库中已存在的Anomalie与Product建立多对多关联。使用通用批量插入方法时，关联已获取的Anomalie会触发**"Id=X的Anomalie实体已被跟踪"**错误，即使仅创建含Id的空Anomalie对象也无法解决，且必须保留AddRange批量操作。

当前代码情况 #

通用批量插入方法 #

public virtual async Task<IList<T>> AddBulkAsync(ICollection<T> entities)
{
    try
    {
        await _dbContext.Set<T>().AddRangeAsync(entities);
        await _dbContext.SaveChangesAsync();
    
        _logger.LogInformation($"Entité ajoutée avec succès - {typeof(T).Name}");
        return entities.ToList();
    }
    catch (Exception ex)
    {
        _logger.LogError($"Impossible d'ajouter l'entité {typeof(T).Name} : {ex.Message}");
    }
   
    return new List<T>();
}

正常插入（无Anomalie关联） #

var modulesToInsert = new List<Module>() {
     new Module() {
        Products = new List<Product>() {
            new Product() { ... },
            new Product() { ... },
            new Product() { ... },
        }
    }
};

await AddBulkAsync(moduleToInsert); // 运行正常

出错场景（关联Anomalie） #

var anomalie1 = await GetAnomalieWithIdAsync(1); // 从数据库获取的跟踪实体
var anomalie2 = await GetAnomalieWithIdAsync(2);

var modulesToInsert2 = new List<Module>() {
     new Module() {
        Products = new List<Product>() {
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
        }
    }
};

await AddBulkAsync(moduleToInsert2); // 触发跟踪冲突错误

可行解决方案 #

方案1：获取Anomalie时使用无跟踪查询 #

从数据库获取Anomalie时，通过AsNoTracking()让上下文不跟踪这些实体，后续AddRange处理新对象图时，EF会识别这些Anomalie为已存在，仅创建关联关系而非尝试插入：

// 修改GetAnomalieWithIdAsync内部逻辑，或直接使用无跟踪查询
var anomalie1 = await _dbContext.Anomalies.AsNoTracking().FirstOrDefaultAsync(a => a.Id == 1);
var anomalie2 = await _dbContext.Anomalies.AsNoTracking().FirstOrDefaultAsync(a => a.Id == 2);

// 后续创建Module和Product的代码保持不变
var modulesToInsert2 = new List<Module>() {
     new Module() {
        Products = new List<Product>() {
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
        }
    }
};

await AddBulkAsync(moduleToInsert2);

方案2：手动重置Anomalie的实体状态 #

如果已获取了跟踪状态的Anomalie，可在AddRange之后、SaveChanges之前，将这些Anomalie的状态设置为Unchanged，告知EF它们是已存在的实体，无需插入：

var anomalie1 = await GetAnomalieWithIdAsync(1);
var anomalie2 = await GetAnomalieWithIdAsync(2);

var modulesToInsert2 = new List<Module>() {
     new Module() {
        Products = new List<Product>() {
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
        }
    }
};

// 先执行AddRange，暂不调用SaveChanges
_dbContext.Set<Module>().AddRange(modulesToInsert2);

// 遍历所有关联的Anomalie，设置状态为Unchanged
foreach(var module in modulesToInsert2)
{
    foreach(var product in module.Products)
    {
        foreach(var anomalie in product.Anomalies)
        {
            _dbContext.Entry(anomalie).State = EntityState.Unchanged;
        }
    }
}

// 手动执行保存操作
try
{
    await _dbContext.SaveChangesAsync();
    _logger.LogInformation($"Entité ajoutée avec succès - {typeof(Module).Name}");
}
catch(Exception ex)
{
    _logger.LogError($"Impossible d'ajouter l'entité {typeof(Module).Name} : {ex.Message}");
}

方案3：使用仅含Id的Anomalie对象并设置状态 #

若不想从数据库查询Anomalie，可直接创建仅包含Id的对象，然后手动标记为Unchanged，避免EF将其视为新实体：

var anomalie1 = new Anomalie { Id = 1 };
var anomalie2 = new Anomalie { Id = 2 };

// 将对象附加到上下文并标记为已存在
_dbContext.Anomalies.Attach(anomalie1);
_dbContext.Anomalies.Attach(anomalie2);
_dbContext.Entry(anomalie1).State = EntityState.Unchanged;
_dbContext.Entry(anomalie2).State = EntityState.Unchanged;

// 后续创建Module和Product的代码保持不变
var modulesToInsert2 = new List<Module>() {
     new Module() {
        Products = new List<Product>() {
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
            new Product() { Anomalies  = new List<Anomalie>() { anomalie1, anomalie2 } },
        }
    }
};

await AddBulkAsync(moduleToInsert2);

核心原因 #

AddRangeAsync会将整个对象图中的所有实体标记为Added状态，包括关联的Anomalie。若这些Anomalie已被上下文跟踪（或手动创建的对象被EF误认为新实体），EF会尝试插入它们，从而触发主键冲突或跟踪冲突错误。通过上述方法告知EF这些Anomalie是已存在的实体，即可避免错误。

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