EF Core更新实体报错：已存在同ID Address跟踪实体问题排查与解决

问题场景 #

开发基于.NET 6 Web API的Xamarin应用，使用Entity Framework Core作为ORM连接SQL Server数据库。更新Customer实体时出现异常：通过Postman先调用GET接口再调用PUT接口可正常完成更新，但Xamarin应用执行相同流程时，抛出类型为Address、Id为400的实体已被跟踪，无法添加新的实例的错误。

相关代码 #

Customer实体类定义 #

public class Customer 
{ 
    public int Id { get; set; }
    public int? IdMetier { get; set; }
    public int IdAdresseFacture { get; set; }
    public int? IdAdresseBl { get; set; }
 
    [ForeignKey("IdMeier")]
    public N17Metier? Metier { get; set; }
   
    [ForeignKey("IdAdresseFacture")]
    public Adress AdresseFacture { get; set; } = new Adress();
    
    [ForeignKey("IdAdresseBl")]
    public Adress? AdresseBl { get; set; } = new Adress();
}

获取客户的GET接口实现 #

public async Task<IActionResult> GetClient(int idClient)
{
    var client = await _dbContext.N1Clients
                                 .Include(c => c.AdresseBl)
                                 .Include(c => c.AdresseFacture)
                                 .Include(c => c.Metier)
                                 .FirstOrDefaultAsync(c => c.Id == idClient);

    return Ok(client);
}

更新客户的PUT接口实现 #

public async Task<IActionResult> ModifyClient(int idClient, [FromBody] N1Client client)
{
    if (client is null)
        return BadRequest();

    if (idClient != client.IdCrm)
        return BadRequest();

    var entity = await _dbContext.N1Clients.FirstOrDefaultAsync(c => c.Id == idClient);

    if (entity is null)
        return NotFound();

    var isExist = await _dbContext.N1Clients.AnyAsync(c => c.Id == idClient);

    if (!isExist)
        return NotFound();

    client.DtMaj = DateTime.Now;

    _dbContext.Update(client);
    await _dbContext.SaveChangesAsync(CancellationToken.None);

    return NoContent();
}

排查与原因分析 #

1. 首先排查DbContext生命周期：已设置为Scoped，每次请求会创建新实例，排除上下文复用导致的跟踪问题。
2. 通过_dbContext.ChangeTracker.Entries()检查当前跟踪的实体，未发现异常记录。
3. 对比Postman与Xamarin请求的差异：Postman请求中Customer的Evenement子集合为空，而Xamarin请求中该集合包含数据。
4. 最终定位问题：Customer实体包含Evenement子集合，Evenement类中也定义了Adress属性；更新时未清空该子集合，导致子集合中的Adress与Customer自身关联的Adress ID重复，EF Core在跟踪实体时出现冲突。

解决方案 #

• 方案1：清理重复关联实体：在更新Customer前，清空Evenement子集合中与Customer自身Adress ID重复的实例，确保每个Adress实体在上下文跟踪中唯一。
• 方案2：精准更新主实体：避免使用_dbContext.Update(client)自动跟踪所有关联实体，改为仅更新Customer主实体的属性，示例代码如下：

// 替换原来的_dbContext.Update(client)
_dbContext.Entry(entity).CurrentValues.SetValues(client);
// 如需更新关联实体，单独处理
if (client.AdresseFacture != null)
{
    _dbContext.Entry(entity.AdresseFacture).CurrentValues.SetValues(client.AdresseFacture);
}
await _dbContext.SaveChangesAsync(CancellationToken.None);

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