ASP.NET Web API：不使用EF跟踪时如何精准记录用户更新

核心思路 #

通过无跟踪查询获取旧数据，对比新旧实体的字段差异，生成结构化的审计日志并持久化存储。以下是具体实现步骤：

1. 定义审计日志实体 #

先创建用于存储变更记录的实体类，记录操作人、变更时间、具体修改字段等信息：

public class AuditLog
{
    public int Id { get; set; }
    public string EntityType { get; set; } // 标识实体类型，如"AppUsers"
    public string EntityId { get; set; } // 被修改用户的ID
    public string UpdatedBy { get; set; } // 操作人ID/用户名
    public DateTime UpdatedAt { get; set; } // 操作时间
    public List<AuditLogChange> Changes { get; set; } = new List<AuditLogChange>(); // 具体变更项
}

public class AuditLogChange
{
    public string FieldName { get; set; } // 修改的字段名
    public string OldValue { get; set; } // 旧值
    public string NewValue { get; set; } // 新值
}

2. 调整更新方法，获取无跟踪的旧数据 #

替换原有的FindByIdAsync（会触发EF跟踪），改用AsNoTracking()查询旧数据，确保不干扰EF的跟踪机制：

public async Task<CreateSuperUserResponse> UpdateAdmin(AppUsers appuser)
{
    // 无跟踪查询获取数据库中的旧用户数据
    var oldUser = await application.Users.AsNoTracking().FirstOrDefaultAsync(x => x.Id == appuser.Id);
    if (oldUser == null)
    {
        return new CreateSuperUserResponse { Success = false, Message = "用户不存在" };
    }

    // 补充旧用户的角色信息（AsNoTracking不会自动加载导航属性）
    oldUser.Role = (await manager.GetRolesAsync(oldUser)).Select(role => new UserRole(role)).ToList();

    // 获取待更新的用户实体（用于执行更新操作）
    var user = await manager.FindByIdAsync(appuser.Id);
    if (user != null)
    {
        // 执行字段更新
        user.Email = appuser.Email;
        user.FullName = appuser.FullName;
        user.PhoneNumber = appuser.PhoneNumber;

        var result = await manager.UpdateAsync(user);
        if (result.Succeeded)
        {
            // 获取更新后的角色信息（若角色也同步更新）
            var newRoles = (await manager.GetRolesAsync(user)).Select(role => new UserRole(role)).ToList();
            appuser.Role = newRoles;

            // 生成并保存审计日志
            var currentUserId = User.FindFirst(ClaimTypes.NameIdentifier)?.Value; // 从当前上下文获取操作人ID
            var auditLog = GenerateAuditLog(oldUser, appuser, currentUserId);
            await SaveAuditLog(auditLog);

            return new CreateSuperUserResponse { Success = true };
        }
        else
        {
            return new CreateSuperUserResponse 
            { 
                Success = false, 
                Message = string.Join(", ", result.Errors.Select(e => e.Description)) 
            };
        }
    }

    return new CreateSuperUserResponse { Success = false, Message = "用户不存在" };
}

3. 实现新旧实体差异对比逻辑 #

编写方法对比旧数据和新数据的字段差异，生成具体的变更项：

private AuditLog GenerateAuditLog(AppUsers oldUser, AppUsers newUser, string updatedBy)
{
    var auditLog = new AuditLog
    {
        EntityType = nameof(AppUsers),
        EntityId = oldUser.Id,
        UpdatedBy = updatedBy,
        UpdatedAt = DateTime.UtcNow
    };

    // 对比Email字段
    if (oldUser.Email != newUser.Email)
    {
        auditLog.Changes.Add(new AuditLogChange
        {
            FieldName = nameof(AppUsers.Email),
            OldValue = oldUser.Email,
            NewValue = newUser.Email
        });
    }

    // 对比FullName字段
    if (oldUser.FullName != newUser.FullName)
    {
        auditLog.Changes.Add(new AuditLogChange
        {
            FieldName = nameof(AppUsers.FullName),
            OldValue = oldUser.FullName,
            NewValue = newUser.FullName
        });
    }

    // 对比PhoneNumber字段
    if (oldUser.PhoneNumber != newUser.PhoneNumber)
    {
        auditLog.Changes.Add(new AuditLogChange
        {
            FieldName = nameof(AppUsers.PhoneNumber),
            OldValue = oldUser.PhoneNumber,
            NewValue = newUser.PhoneNumber
        });
    }

    // 对比角色集合
    var oldRoleNames = oldUser.Role.Select(r => r.RoleName).ToList();
    var newRoleNames = newUser.Role.Select(r => r.RoleName).ToList();
    
    if (!oldRoleNames.SequenceEqual(newRoleNames))
    {
        auditLog.Changes.Add(new AuditLogChange
        {
            FieldName = nameof(AppUsers.Role),
            OldValue = string.Join(", ", oldRoleNames),
            NewValue = string.Join(", ", newRoleNames)
        });
    }

    return auditLog;
}

4. 持久化审计日志 #

编写方法将生成的审计日志保存到数据库：

private async Task SaveAuditLog(AuditLog auditLog)
{
    // 使用项目的DbContext添加并保存日志
    application.AuditLogs.Add(auditLog);
    await application.SaveChangesAsync();
}

关键注意事项 #

• 确保获取旧数据时使用AsNoTracking()，完全规避EF的实体跟踪机制
• 操作人信息需从当前请求上下文获取（如通过Claims），保证日志的准确性
• 对于复杂类型或导航属性（如角色），需单独处理集合的对比逻辑
• 若需要更通用的对比逻辑，可以使用反射遍历实体字段，减少重复代码

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