基于C#与Entity Framework的MVC实体/对象变更追踪方案咨询

在C# MVC + Entity Framework的项目里做实体变更追踪和审计日志，我有几个实战过的方案，刚好能覆盖你提到的「属性变更追踪、新增项目记录、操作内容+操作者日志」这些需求，分享给你：

1. 利用EF原生ChangeTracker（最省心的原生方案） #

EF本身自带的ChangeTracker就是专门用来追踪实体状态的，完全不用额外依赖，是我最常用的方案之一。核心思路是重写DbContext的SaveChanges/SaveChangesAsync方法，在保存操作执行前拦截并提取变更信息。

实现步骤： #

• 重写DbContext的保存方法，遍历ChangeTracker里的所有实体
• 区分实体状态：Added（新增）、Modified（修改），分别处理
• 从MVC的HttpContext中获取当前登录用户的ID（可以通过HttpContext.User或者依赖注入的用户服务）
• 把操作类型、实体类型、变更内容、操作者、时间等信息存入审计日志实体，再一起提交保存

代码示例： #

public class YourDbContext : DbContext
{
    // 假设你已经通过依赖注入拿到HttpContextAccessor
    private readonly IHttpContextAccessor _httpContextAccessor;

    public YourDbContext(DbContextOptions<YourDbContext> options, IHttpContextAccessor httpContextAccessor) 
        : base(options)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public override int SaveChanges()
    {
        var userId = _httpContextAccessor.HttpContext?.User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
        var auditLogs = new List<AuditLog>();

        // 筛选出新增或修改的实体
        foreach (var entry in ChangeTracker.Entries()
            .Where(e => e.State is EntityState.Added or EntityState.Modified))
        {
            var auditLog = new AuditLog
            {
                EntityTypeName = entry.Entity.GetType().Name,
                OperationType = entry.State.ToString(),
                OperatorId = userId,
                OperationTime = DateTime.UtcNow
            };

            if (entry.State == EntityState.Added)
            {
                // 记录新增实体的所有属性值
                auditLog.ChangeDetails = JsonSerializer.Serialize(entry.CurrentValues.ToObject());
            }
            else if (entry.State == EntityState.Modified)
            {
                // 对比原始值和当前值，提取变更的属性
                var changes = new Dictionary<string, object>();
                foreach (var prop in entry.OriginalValues.Properties)
                {
                    var original = entry.OriginalValues[prop];
                    var current = entry.CurrentValues[prop];
                    if (!Equals(original, current))
                    {
                        changes[prop.Name] = new { OriginalValue = original, CurrentValue = current };
                    }
                }
                auditLog.ChangeDetails = JsonSerializer.Serialize(changes);
            }

            auditLogs.Add(auditLog);
        }

        // 先添加审计日志到上下文，再执行原始保存逻辑
        Set<AuditLog>().AddRange(auditLogs);
        return base.SaveChanges();
    }
}

// 审计日志实体示例
public class AuditLog
{
    public int Id { get; set; }
    public string EntityTypeName { get; set; }
    public string OperationType { get; set; }
    public string OperatorId { get; set; }
    public DateTime OperationTime { get; set; }
    public string ChangeDetails { get; set; } // 用JSON存储变更内容
}

优缺点： #

• ✅ 无额外依赖，原生支持，代码侵入性低
• ✅ 自动覆盖新增、修改实体的追踪
• ❌ 对于导航属性的变更（比如关联实体的新增/删除）需要额外处理
• ❌ 只能在保存时批量记录变更，无法实时追踪单个属性的变更

2. 实现INotifyPropertyChanged（细粒度实时追踪） #

如果需要更细粒度的控制——比如属性一发生变更就记录，而不是等到SaveChanges时才批量处理，可以让实体实现INotifyPropertyChanged接口，在属性setter里主动触发变更通知并记录。

实现步骤： #

• 定义一个基类BaseEntity，实现INotifyPropertyChanged，并维护一个存储属性变更的集合
• 所有需要追踪的实体都继承这个基类，在属性的setter里调用变更通知方法
• 同样在DbContext的SaveChanges方法里，读取实体自身记录的变更信息，生成审计日志

代码示例： #

public abstract class BaseEntity : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;
    public Dictionary<string, (object Original, object Current)> PropertyChanges { get; } = new();

    protected virtual void OnPropertyChanged(string propertyName, object originalValue, object currentValue)
    {
        if (!Equals(originalValue, currentValue))
        {
            PropertyChanges[propertyName] = (originalValue, currentValue);
        }
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    // 示例属性写法，所有实体属性都要按这个格式写
    private string _title;
    public string Title
    {
        get => _title;
        set
        {
            var original = _title;
            _title = value;
            OnPropertyChanged(nameof(Title), original, value);
        }
    }
}

然后在DbContext的SaveChanges里：

public override int SaveChanges()
{
    var userId = _httpContextAccessor.HttpContext?.User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
    var auditLogs = new List<AuditLog>();

    foreach (var entry in ChangeTracker.Entries<BaseEntity>())
    {
        var log = new AuditLog
        {
            EntityTypeName = entry.Entity.GetType().Name,
            OperatorId = userId,
            OperationTime = DateTime.UtcNow
        };

        switch (entry.State)
        {
            case EntityState.Added:
                log.OperationType = "Added";
                log.ChangeDetails = JsonSerializer.Serialize(entry.CurrentValues.ToObject());
                break;
            case EntityState.Modified:
                log.OperationType = "Modified";
                // 直接用实体自身记录的变更，比EF的OriginalValues更准确（比如中途多次修改同一属性）
                log.ChangeDetails = JsonSerializer.Serialize(entry.Entity.PropertyChanges);
                // 清空变更记录，避免下次保存重复提交
                entry.Entity.PropertyChanges.Clear();
                break;
        }

        auditLogs.Add(log);
    }

    Set<AuditLog>().AddRange(auditLogs);
    return base.SaveChanges();
}

优缺点： #

• ✅ 实时追踪单个属性的变更，能记录多次修改的最终结果
• ✅ 可以在属性变更时触发额外逻辑（比如实时通知）
• ❌ 实体代码侵入性高，所有属性都要手动修改setter（可以用T4模板自动生成）
• ❌ 已有项目改造成本较高

3. 借助第三方审计库（快速上线方案） #

如果不想自己造轮子，成熟的第三方库已经封装好了所有你需要的功能，比如EntityFramework.Audit、Audit.NET这类，支持实体变更追踪、新增记录、操作者信息注入，甚至可以配置日志存储到数据库、文件或其他介质。

核心思路： #

• 安装对应的NuGet包
• 配置审计上下文，继承你的DbContext
• 通过库的API注入当前操作者信息，配置日志格式
• 剩下的追踪和记录工作完全由库自动完成

优缺点： #

• ✅ 零手写追踪逻辑，快速上线，功能完善（支持批量操作、导航属性变更等复杂场景）
• ✅ 可定制性强，支持多种存储方式
• ❌ 引入第三方依赖，需要学习配置规则，极端定制化需求可能不如自己写的灵活

4. 结合MVC ActionFilter（记录操作上下文） #

如果需要补充记录操作的上下文信息（比如哪个Controller/Action触发的变更、请求路径等），可以结合MVC的ActionFilterAttribute，在Action执行前后拦截并提取这些信息，再整合到审计日志里。

实现思路： #

• 自定义一个AuditActionFilter，继承ActionFilterAttribute
• 在OnActionExecuted方法里，获取当前DbContext的ChangeTracker，生成审计日志
• 从ActionContext中提取Controller、Action、请求URL等信息，添加到审计日志的额外字段中

这个方案通常作为前三个方案的补充，让审计日志的信息更完整。

方案选择建议： #

• 小型项目/不想加依赖：优先选方案1（EF ChangeTracker）
• 需要实时细粒度追踪：选方案2（INotifyPropertyChanged）
• 追求快速上线、功能完善：选方案3（第三方库）
• 需要记录操作上下文：结合方案4（ActionFilter）

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