Audit.EntityFramework.Core 16.2.1 PUT请求下Foreign Object变更未被跟踪问题咨询

我之前在项目里也遇到过一模一样的问题——用POST请求提交包含关联对象的 payload 时，GetEntityFrameworkEvent()能正确输出所有变更；但换成PUT请求，Audit.EntityFramework.Core 16.2.1 就完全抓不到关联对象的修改，Changes数组里每个字段的New和Old值完全一致，根本体现不出实际改了什么。

问题根源分析 #

这个坑主要和EF Core的状态跟踪逻辑，以及Audit库的变更捕获机制有关：

• EF Core的Update()行为：如果处理PUT请求时直接把DTO映射成实体后调用context.Update(entity)，EF Core会把整个实体标记为Modified，但对于嵌套的关联对象，除非这些对象本身的状态被EF Core识别为变更（比如你手动修改了关联对象的属性，且EF Core在跟踪它），否则EF Core不会认为关联对象有变化。
• Audit.EFCore的依赖关系：Audit库的变更捕获完全依赖EF Core上下文的状态跟踪结果。如果EF Core没标记关联对象为变更状态，Audit库自然也抓不到对应的修改。

可行的解决方案 #

1. 改用"先查后更"的方式处理PUT请求

不要直接用Update()覆盖实体，而是先从数据库加载包含关联对象的原实体，再把DTO的变更逐一映射到原实体的属性上。这样EF Core能精准检测到每个属性的变化，Audit库也能正确捕获：

// 错误示范：直接映射后调用Update
var updatedEntity = _mapper.Map<MainEntity>(putDto);
_context.MainEntities.Update(updatedEntity);

// 正确姿势：先查询原实体（包含关联对象），再更新属性
var existingEntity = await _context.MainEntities
    .Include(e => e.ForeignObject) // 必须加载关联对象才能检测变更
    .FirstOrDefaultAsync(e => e.Id == putDto.Id);

if (existingEntity != null)
{
    // 映射主实体的属性变更
    _mapper.Map(putDto, existingEntity);
    // 手动映射关联对象的属性（如果AutoMapper没配置深度映射）
    _mapper.Map(putDto.ForeignObject, existingEntity.ForeignObject);
    
    // 不需要调用Update，EF Core会自动跟踪所有属性变更
    await _context.SaveChangesAsync();
}

2. 配置Audit.EFCore显式跟踪关联实体

在你的Audit初始化配置中，开启关联实体的审计跟踪，确保Audit库能深度检测嵌套对象的变更：

Audit.Core.Configuration.Setup()
    .UseEntityFramework(options => options
        .AuditTypeMapper(type => typeof(AuditLogEntry)) // 你的审计日志实体类型
        .AuditEntityAction<AuditLogEntry>((auditEvent, entry, auditEntry) =>
        {
            // 自定义审计日志的字段映射逻辑
            auditEntry.EntityType = entry.EntityType.Name;
            auditEntry.Changes = entry.Changes;
            // ...其他映射
        })
        .IncludeEntityObjects(true)
        .AuditIncludeAssociations(true)); // 关键：启用关联实体的审计

3. 升级Audit.EntityFramework.Core到最新版本

这个问题在16.2.1之后的版本中已经被官方修复了，很多用户反馈升级到19.x及以上版本后，关联对象的PUT变更跟踪就正常了。你可以通过NuGet命令升级：

Install-Package Audit.EntityFramework.Core -Version [LatestStableVersion]

验证效果 #

完成上述操作后，再发起PUT请求，调用GetEntityFrameworkEvent()查看审计结果，就能看到关联对象字段的Old和New值正确显示出修改前后的差异了。

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