如何优雅解决Entity Framework中用户自引用对象更新错误？

项目基础背景 #

• 所有模型继承自Entity类，核心属性：

public Guid Id { get; set; }
public DateTime Created { get; set; }
public required User CreatedBy { get; set; }
public DateTime? Modified { get; set; }
public User? ModifiedBy { get; set; }

• 控制器CRUD规则：
  • Post请求：通过Dto创建对象，赋值CreatedBy为操作用户，设置Created为当前时间，调用AddAsync()保存
  • Put请求：从数据库获取旧对象修改，赋值ModifiedBy为操作用户，设置Modified为当前时间，调用Update()保存
• 数据库使用PostgreSQL

问题场景 #

UsersController中支持用户自我修改（如姓名、密码），但执行自更新的Put请求时，Update()抛出跟踪冲突错误：

{"The instance of entity type 'User' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the conflicting key values."}

当前Put方法代码 #

public async Task<IActionResult> PutAsync(Guid id, [FromBody] UserDto userDto, [FromQuery] Guid actingUserId)
{
    // 验证传入id（非操作用户ID），细节略
    try
    {
        User? modifyingUser = await _context.Users.AsNoTracking().SingleOrDefaultAsync(x => x.Id == actingUserId);
        if (modifyingUser == null)
        {
            _logger.LogDebug("Given UserId is invalid! -> BadRequest");
            return BadRequest();
        }
        User? userToUpdate = await _context.Users.AsNoTracking().SingleOrDefaultAsync(x => x.Id == userDto.Id);
        if (userToUpdate == null)
        {
            _logger.LogDebug("Given UserId was not found in Database. -> NotFound");
            return NotFound();
        }
        Role? role = null;
        if (userDto.Role != null)
        {
            role = await _context.Roles.SingleOrDefaultAsync(x => x.Id == userDto.Role.Id);
            if (role == null)
            {
                _logger.LogDebug("Given RoleId is invalid! -> BadRequest");
                return BadRequest();
            }
        }
        User modifiedUser = _userService.ToModifiedUser(userDto, userToUpdate, modifyingUser, role); 
        UserDto modifiedUserDto = _userService.ToUserDto(modifiedUser, modifiedUser.Role != null ? _roleService.ToRoleDto(modifiedUser.Role) : null);
        _context.Users.Update(modifiedUser);
        _context.SaveChanges();
        _logger.LogDebug("Updated User: {ModifiedUser}", modifiedUser);
        return Ok(modifiedUserDto);
    }
    catch (Exception)
    {
        _logger.LogDebug("Ran into an Error while updating User!!");
        return StatusCode(StatusCodes.Status500InternalServerError, "Error updating Data");
    }
}

已尝试但无效的方案 #

• 调整各_context调用的AsNoTracking()
• 在Update前调用_context.ChangeTracker.Clear()
• 手动Attach() modifiedUser并设置状态为Modified后调用SaveChanges()

临时不够优雅的Workaround #

• 使用原生SQL直接更新ModifiedById字段
• 将ModifiedBy设为Null（仅保留Modified时间）
• 预置标准用户作为自更新的操作用户

优雅解决方案 #

方案1：直接设置外键值而非导航属性 #

如果你的Entity类中还没有对应外键字段，先补充外键并配置EF关联：

public Guid Id { get; set; }
public DateTime Created { get; set; }
public Guid CreatedById { get; set; }
public required User CreatedBy { get; set; }
public DateTime? Modified { get; set; }
public Guid? ModifiedById { get; set; }
public User? ModifiedBy { get; set; }

（可通过Fluent API或数据注解配置外键与导航属性的关联）

修改ToModifiedUser方法逻辑，自更新时直接赋值外键ID，避免传递完整User实体：

// 在_userService.ToModifiedUser方法中添加判断
if (userToUpdate.Id == modifyingUser.Id)
{
    modifiedUser.ModifiedById = modifyingUser.Id;
    modifiedUser.ModifiedBy = null; // 避免加载导航属性触发跟踪冲突
}
else
{
    modifiedUser.ModifiedBy = modifyingUser;
}
modifiedUser.Modified = DateTime.UtcNow;

保存时EF会自动通过外键关联导航属性，无需传递完整实体，从根源避免重复跟踪。

方案2：手动设置实体状态，替代Update全量跟踪 #

放弃使用_context.Users.Update(modifiedUser)，改为通过Entry手动更新属性：

// 替换原有的Update和SaveChanges代码
var entry = _context.Entry(userToUpdate);
entry.CurrentValues.SetValues(modifiedUser);

// 单独设置修改时间和操作用户
entry.Property(x => x.Modified).CurrentValue = DateTime.UtcNow;
if (userToUpdate.Id == actingUserId)
{
    entry.Property(x => x.ModifiedById).CurrentValue = actingUserId;
}
else
{
    entry.Reference(x => x.ModifiedBy).CurrentValue = modifyingUser;
}

await _context.SaveChangesAsync();

这种方式复用查询得到的userToUpdate实例，直接更新属性，避免创建新实体导致的跟踪冲突。

方案3：自更新场景下复用同一实体实例 #

修改获取userToUpdate的逻辑，自更新时直接复用modifyingUser：

// 替换原获取userToUpdate的代码
User? userToUpdate;
if (actingUserId == userDto.Id)
{
    userToUpdate = modifyingUser; // 自更新时直接复用已查询的操作用户实例
}
else
{
    userToUpdate = await _context.Users.AsNoTracking().SingleOrDefaultAsync(x => x.Id == userDto.Id);
}

后续生成的modifiedUser中，ModifiedBy和主实体是同一个实例，不会触发跟踪冲突。

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