ASP.NET Razor Pages EF Core实体跟踪冲突问题求助及解决

问题场景 #

• 开发Razor Pages的「编辑分类（Edit Category）」页面时，为实现自定义错误校验，调用ToListAsync()加载了categories表的全部数据
• 在OnPost()方法中调用Update()编辑目标分类时，抛出异常：InvalidOperationException: 同一主键{'Id'}的Category实例已被跟踪
• 同时需要在编辑流程中调整其他分类的displayOrder

问题原因 #

EF Core的上下文会自动跟踪从数据库加载的实体实例。当你用ToListAsync()加载所有分类后，要编辑的目标分类实例已经被上下文跟踪；后续把页面提交的、带有相同主键的Category模型传入Update()时，上下文发现已有相同主键的跟踪实例，就会触发这个异常。

可行解决方案 #

1. 解除已有实例的跟踪 #

在调用Update()前，检查上下文是否已跟踪目标实例，若存在则将其状态改为Detached解除跟踪，再更新新实例：

var trackedCategory = _context.Categories.Local.FirstOrDefault(c => c.Id == category.Id);
if (trackedCategory != null)
{
    _context.Entry(trackedCategory).State = EntityState.Detached;
}
_context.Update(category);
await _context.SaveChangesAsync();

2. 查询时排除当前编辑的分类 #

如果自定义校验不需要包含正在编辑的分类，直接在查询时过滤掉它，避免上下文跟踪该实例：

// currentCategoryId为当前要编辑的分类ID
var categories = await _context.Categories.Where(c => c.Id != currentCategoryId).ToListAsync();

3. 用无跟踪查询加载分类列表 #

如果加载所有分类仅用于校验、无需修改这些实例，可使用AsNoTracking()让上下文不跟踪加载的实体，后续更新目标分类时就不会有冲突：

var categories = await _context.Categories.AsNoTracking().ToListAsync();

关于调整其他分类的displayOrder #

处理完目标分类的更新后，遍历需要调整displayOrder的分类，修改属性后标记为修改状态再保存：

// adjustCategories为需要调整的分类集合
foreach (var cat in adjustCategories)
{
    _context.Entry(cat).State = EntityState.Modified;
}
await _context.SaveChangesAsync();

自行验证的解决代码 #

// 加载分类时使用无跟踪查询
var categories = await _context.Categories.AsNoTracking().ToListAsync();

// OnPost中的更新逻辑
public async Task<IActionResult> OnPostAsync(int id)
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    var categoryToUpdate = await _context.Categories.FindAsync(id);
    if (categoryToUpdate == null)
    {
        return NotFound();
    }

    // 此处添加调整其他分类displayOrder的逻辑
    // ...

    if (await TryUpdateModelAsync<Category>(
        categoryToUpdate,
        "category",
        c => c.Name, c => c.DisplayOrder))
    {
        await _context.SaveChangesAsync();
        return RedirectToPage("./Index");
    }

    return Page();
}

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