EF Core中IngredientEntity跟踪冲突：批量插入食材失败排查

这个异常的核心原因有两个：

1. EF Core上下文跟踪冲突：当你调用_recipeRepo.UpsertAsync保存食谱时，如果RecipeEntity和IngredientEntity之间存在导航属性关联（比如Recipe包含Ingredients集合），EF Core会自动跟踪所有关联的食材实体。之后你循环单独Upsert每个食材时，同一个ID的食材已经被上下文跟踪，再次尝试跟踪就会触发冲突。
2. 前端请求存在重复ID：虽然你说所有食材ID唯一，但前端传过来的request.Recipe.Ingredients列表里可能存在重复ID的条目，导致两次映射出同一个ID的实体，第二次Upsert时触发跟踪冲突。

先排查前端请求 #

先检查前端提交的食材列表，确认没有重复ID的条目。比如前端是否不小心把同一个食材多次添加到食谱的食材列表里，这是最容易忽略的问题。

方案一：利用导航属性同步食材（推荐） #

如果你的RecipeEntity已经配置了Ingredients导航属性，并且EF Core正确映射了两者的关联关系（比如一对多），那么不需要单独循环Upsert食材。保存食谱时，EF Core会自动根据导航属性里的食材状态（新增/修改）同步到数据库。

修改控制器代码，去掉食材循环的部分：

[HttpPost("saveRecipe")]
public async Task<ActionResult<SaveRecipeResponse>> SaveRecipe(SaveRecipeRequest request, CancellationToken requestAborted)
{
    var recipeEntity = _mapper.Map<RecipeEntity>(request.Recipe);
    await _recipeRepo.UpsertAsync(recipeEntity, requestAborted);
    await _uow.SaveAsync();
    return new SaveRecipeResponse() { Recipe = request.Recipe, Success = true };
}

注意：需要确保你的UpsertAsync方法正确处理导航属性的状态，比如对于新增的食材标记为Added，修改的标记为Modified。

方案二：手动处理跟踪冲突 #

如果必须单独处理食材的Upsert，可以在处理前检查上下文是否已经跟踪了该实体，避免重复跟踪：

[HttpPost("saveRecipe")]
public async Task<ActionResult<SaveRecipeResponse>> SaveRecipe(SaveRecipeRequest request, CancellationToken requestAborted)
{
    await _recipeRepo.UpsertAsync(_mapper.Map<RecipeEntity>(request.Recipe), requestAborted);
    
    foreach (var ing in request.Recipe.Ingredients)
    {
        var ingEntity = _mapper.Map<IngredientEntity>(ing);
        // 检查上下文是否已跟踪该ID的食材
        var trackedIng = _ingRepo.Context.ChangeTracker.Entries<IngredientEntity>()
            .FirstOrDefault(e => e.Entity.Id == ingEntity.Id);
        
        if (trackedIng != null)
        {
            // 已跟踪，直接更新属性值
            _mapper.Map(ing, trackedIng.Entity);
        }
        else
        {
            // 未跟踪，执行Upsert
            await _ingRepo.UpsertAsync(ingEntity, requestAborted);
        }
    }
    
    await _uow.SaveAsync();
    return new SaveRecipeResponse() { Recipe = request.Recipe, Success = true };
}

或者修改你的IngredientRepo的UpsertAsync方法，使用无跟踪查询来避免冲突：

public async Task UpsertAsync(IngredientEntity entity, CancellationToken cancellationToken)
{
    // 用无跟踪查询检查是否存在
    var existing = await _dbContext.Ingredients.AsNoTracking()
        .FirstOrDefaultAsync(e => e.Id == entity.Id, cancellationToken);
    
    if (existing == null)
    {
        await _dbContext.Ingredients.AddAsync(entity, cancellationToken);
    }
    else
    {
        // 手动设置实体状态为修改
        _dbContext.Entry(entity).State = EntityState.Modified;
    }
}

方案三：禁用实体跟踪（不推荐） #

如果以上方案都不适用，可以在查询或更新时禁用EF Core的跟踪功能，比如在UpsertAsync里使用AsNoTracking，或者在映射后将实体状态设置为Detached，但这可能会导致其他状态跟踪问题，仅作为临时应急方案。

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