EF Core泛型架构下HttpPut操作出现0行影响并发异常求助

问题核心原因 #

你遇到的异常本质是：传入的medicalRecord是未被DbContext跟踪的全新实体实例，尽管你先查询了数据库中的对应记录，但查询得到的实例与传入实例是完全独立的对象。直接更新未跟踪的实例时，EF Core无法正确关联到数据库中的对应记录（或主键不匹配），导致更新语句执行后影响0行。泛型Service/Repo本身不是问题，问题出在更新逻辑的实体跟踪处理上。

修复方案 #

1. 映射属性到已跟踪的实体实例 #

在Controller中，查询到数据库中已存在的实体后，将传入的实体属性映射到这个被DbContext跟踪的实例上，再执行更新操作。这样EF Core会自动检测属性变化并生成正确的更新语句。

修改Controller代码：

[HttpPut("{id}")]
public async Task<IActionResult> UpdateMedicalRecord(int id, MedicalRecord medicalRecord)
{
    if (_mediTrackService is null)
    {
        throw new Exception("Service not found");
    }

    try
    {
        // 校验URL ID与请求体ID一致
        if (id != medicalRecord.Id)
        {
            return BadRequest("URL中的ID与请求体中的ID不匹配");
        }

        var existingRecord = await _mediTrackService.GetDataByIdAsync(id);
        if (existingRecord is null)
        {
            return NotFound();
        }

        // 手动映射属性（或使用AutoMapper简化操作）
        existingRecord.PatientName = medicalRecord.PatientName;
        existingRecord.Diagnosis = medicalRecord.Diagnosis;
        existingRecord.TreatmentDate = medicalRecord.TreatmentDate;
        // 补充其他需要更新的属性

        await _mediTrackService.UpdateExistingAsync(existingRecord);
        return Ok(existingRecord); // PUT请求用Ok更符合REST语义，Created多用于POST
    }
    catch (Exception e)
    {
        throw new Exception($"{e.Message}");
    }
}

2. 优化泛型Repository的更新逻辑 #

如果传入的是已被跟踪的实体，不需要手动设置EntityState.Modified，EF Core会自动跟踪属性变化。简化Repository代码：

public async Task UpdateExistingAsync(T entity)
{
    try
    {
        // 已跟踪实体无需手动设置状态，EF自动检测变化
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateConcurrencyException ex)
    {
        throw new DbUpdateConcurrencyException(ex.Message);
    }
}

如果需要支持未跟踪实体的更新（比如跨上下文场景），可以使用_context.Update(entity)，它会自动处理实体的跟踪状态：

public async Task UpdateExistingAsync(T entity)
{
    try
    {
        _context.Update(entity); // 自动处理跟踪状态，无论实体是否已被跟踪
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateConcurrencyException ex)
    {
        throw new DbUpdateConcurrencyException(ex.Message);
    }
}

3. 额外校验：确保主键一致性 #

务必保证URL中的id与请求体中medicalRecord.Id完全一致，否则即使数据库存在对应记录，EF Core也会因主键不匹配导致更新0行。

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