使用AutoMapper更新实体时EF Core抛出跟踪异常的问题排查

1. Identity用户跟踪冲突：ASP.NET Core Identity的UserManager或你的DbContext在请求周期内可能已经跟踪了目标User实体（比如当前登录用户、之前查询过的用户），而AutoMapper从DTO映射出了新的User实例，两者ID一致，EF的ChangeTracker不允许同一键值的多个实体被跟踪。
2. AutoMapper生成未跟踪新实例：更新场景中，直接把UserDto映射成新的User对象，这个对象未被EF跟踪，但数据库里已有对应ID的用户。当你调用Company.Update触发导航属性跟踪时，就会和已存在的跟踪实例冲突。
3. 误用Update方法：context.Companies.Update(dbCompany)会递归标记所有关联实体（包括Users集合）为Modified，哪怕实体没变化，EF也会尝试处理这些关联对象，进而触发跟踪冲突。

1. 直接更新已跟踪的User实体 #

处理关联用户时，不要用AutoMapper生成新的User对象，先从DbContext获取已跟踪的实例（或附加未跟踪实例），再把DTO属性映射到这个实例上：

// 处理CompanyDto中的Users集合
foreach (var userDto in companyDto.Users)
{
    var dbUser = await context.Users.FindAsync(userDto.Id);
    if (dbUser == null)
    {
        // 新增用户：映射后添加到上下文和Company的Users集合
        var newUser = _mapper.Map<User>(userDto);
        context.Users.Add(newUser);
        dbCompany.Users.Add(newUser);
    }
    else
    {
        // 更新已跟踪的用户：直接映射到现有实例
        _mapper.Map(userDto, dbUser);
    }
}

// dbCompany是查询出来的已跟踪实体，修改后直接SaveChanges即可，无需调用Update
await context.SaveChangesAsync();

注意：如果dbCompany是通过Include(c => c.Users)查询的已跟踪实体，修改其属性或导航属性后，EF会自动跟踪变更，不需要手动调用Update。

2. 配置AutoMapper映射到已有实例 #

映射时传入已有的User实例，让AutoMapper直接更新它，而非创建新对象：

var dbUser = await context.Users.FindAsync(userDto.Id);
if (dbUser != null)
{
    _mapper.Map(userDto, dbUser);
}

同时检查AutoMapper配置，确保没有强制生成新实例的规则（比如ConstructUsing）。

3. 分离冲突的跟踪实例（谨慎使用） #

如果确认有重复跟踪的User实例，可以先将其从ChangeTracker中分离，再处理新实例：

var trackedUser = context.Users.Local.FirstOrDefault(u => u.Id == userDto.Id);
if (trackedUser != null)
{
    context.Entry(trackedUser).State = EntityState.Detached;
}

// 映射并更新用户
var user = _mapper.Map<User>(userDto);
context.Users.Update(user);

警告：这种方法会丢失分离实体的未保存变更，仅在确认无未提交更改时使用。

4. 用AsNoTracking查询Company #

如果只是读取Company数据用于映射更新，不需要跟踪原始实体，可以用AsNoTracking查询，避免原始实体被跟踪：

var dbCompany = await context.Companies
    .Include(c => c.Users)
    .AsNoTracking()
    .FirstOrDefaultAsync(c => c.Id == companyDto.Id);

// 映射更新后调用Update
_mapper.Map(companyDto, dbCompany);
context.Companies.Update(dbCompany);
await context.SaveChangesAsync();

注意：要确保所有关联的User实例没有被其他地方跟踪，否则仍会冲突。

• Identity用户的跟踪状态不要随意修改，尤其是当前登录用户，UserManager内部可能已经在跟踪该用户。
• 已跟踪的实体无需手动调用Update，EF会自动检测变更，Update仅适用于未跟踪的实体。
• 报错前可以打印context.ChangeTracker.Entries()的信息，查看所有被跟踪的实体，确认是否有重复的User实例。

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