.NET中Mapster映射IdentityUser与DTO的实体跟踪冲突问题

错误原因 #

你遇到的问题核心是DbContext实体跟踪机制的冲突：

1. 通过_userManager.FindByIdAsync查询到的user实例已经被DbContext标记为跟踪状态
2. 调用model.Adapt<IdentityUser>(...)时，Mapster创建了一个全新的IdentityUser实例，且该实例的Id与之前查询到的实例完全相同
3. 当执行_userManager.UpdateAsync(user)时，DbContext发现存在两个拥有相同主键的IdentityUser实例，因此抛出跟踪冲突异常

修复方案 #

不要创建新的IdentityUser实例，而是直接将UpdateUserDto的属性映射到已经被DbContext跟踪的user实例上，具体修改如下：

1. 调整Mapster映射配置（可选但建议） #

原配置中双向映射的字段对应关系需要修正，确保UpdateUserDto到IdentityUser的映射逻辑正确：

public static TypeAdapterConfig MapUserToUpdateUserDto()
{
    var config = new TypeAdapterConfig();
    // 明确配置Dto到实体的映射方向，再开启双向
    config.NewConfig<UpdateUserDto, IdentityUser>()
        .Map(dest => dest.PhoneNumber, src => src.PhoneNumber)
        .Map(dest => dest.Email, src => src.Email)
        .Map(dest => dest.UserName, src => src.UserName)
        .Map(dest => dest.EmailConfirmed, src => src.Active)
        .Map(dest => dest.PhoneNumberConfirmed, src => src.Active)
        .TwoWays();
    return config;
}

2. 修改UpdateUser方法 #

移除创建新实例的代码，直接将Dto数据适配到已有的跟踪实例：

public async Task UpdateUser(UpdateUserDto model)
{
    var user = await _userManager.FindByIdAsync(model.Id!);
    // 直接将model的数据映射到已存在的user实例，而非创建新实例
    model.Adapt(user, UserMapster.MapUserToUpdateUserDto());
    
    var resultUpdateUser = await _userManager.UpdateAsync(user);

    if (resultUpdateUser.Succeeded)
    {
        if (!string.IsNullOrEmpty(model.Password) && !string.IsNullOrEmpty(model.PasswordConfirmed))
        {
            var token = await _userManager.GeneratePasswordResetTokenAsync(user);
            await _userManager.ResetPasswordAsync(user, token, model.Password);
        }

        var roles = await _userManager.GetRolesAsync(user!);

        await _userManager.RemoveFromRolesAsync(user, roles);
        await _userManager.AddToRolesAsync(user, model.Role!);
    }
}

关键注意事项 #

• 永远不要在已有跟踪实例的情况下，创建同主键的新实体实例，这会直接触发DbContext的跟踪冲突
• Mapster的Adapt方法支持将源对象数据映射到目标实例，而非总是创建新对象，这是解决此类问题的核心
• 确保映射配置的字段对应关系正确，避免出现重复映射导致的属性覆盖问题（比如原配置中两次映射Active会导致最后一次映射覆盖前一次）

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