EF Core单审计实体关联多父类型外键冗余问题方案问询

当前设计中EF Core会按约定识别IAudited接口定义的List<AuditEntry> AuditEntries集合导航属性，自动为每个实现IAudited的实体在AuditEntry表生成单独外键列。随着审计实体增多，AuditEntry表会出现大量可空冗余外键列，维护成本极高。

不需要为每个实体单独建审计表，只需要调整实体定义和EF Core配置，切断自动生成的外键关联，改用显式字段存储被审计实体标识即可，完全满足全局审计检索需求。

第一步：调整AuditEntry实体定义 #

移除依赖导航属性关联的设计，新增字段存储被审计实体主键值，不需要让AuditEntry关联各个业务实体的导航属性：

public class AuditEntry : IEntity
{
    public Guid ID { get; set; }

    [MaxLength(100)]
    public string EntityType { get; set; } = "";

    [MaxLength(500)]
    public string EntityName { get; set; } = "";

    // 存储被审计实体主键值，不配置外键约束
    public Guid EntityID { get; set; }

    public Guid UserID { get; set; } = Guid.Empty;
    public DateTime ChangeDate { get; set; } = DateTime.UtcNow;

    public ChangeType ChangeType { get; set; } = ChangeType.None;

    public List<FieldChangeAudit> Changes { get; set; } = new List<FieldChangeAudit>();
}

第二步：调整IAudited接口定义 #

移除集合导航属性定义，避免EF Core按约定自动识别实体关系：

public interface IAudited: IEntity
{
    string EntityName { get; }
    string EntityType { get; }
    // 移除原List<AuditEntry> AuditEntries属性定义
}

对应业务实体（如Workspace）同步删除AuditEntries集合属性即可：

public class Workspace : ITemporalTracking, IAudited
{
    public Guid ID { get; set; }

    // ...其他业务属性

    [NotMapped]
    public string EntityName => Name; 

    [NotMapped]
    public string EntityType => "Workspace";

    // 移除原public List<AuditEntry> AuditEntries { get; set; }属性
}

第三步：调整审计跟踪逻辑 #

不再通过导航属性挂载审计记录，直接将AuditEntry作为独立实体添加到DbContext，同时给EntityID赋值：

private void ApplyAuditTracking()
{
    ChangeTracker.DetectChanges();
    var auditSet = Set<AuditEntry>();

    foreach (var item in ChangeTracker.Entries<IAudited>())
    {
        if(item.State == EntityState.Detached || item.State == EntityState.Unchanged)
            continue;

        List<FieldChangeAudit> fieldChanges = new List<FieldChangeAudit>();

        foreach (var fld in item.Properties)
        {
            // 可自行添加过滤规则：跳过主键、并发令牌、更新时间等不需要审计的字段
            if (fld.Metadata.IsPrimaryKey()) continue;
            
            if(fld.OriginalValue != fld.CurrentValue || item.State == EntityState.Added)
            {
                fieldChanges.Add(new FieldChangeAudit() { 
                    FieldName = fld.Metadata.Name, 
                    OldValue = item.State == EntityState.Added ? null : fld.OriginalValue?.ToString() ?? "", 
                    NewValue = item.State == EntityState.Deleted ? null : fld.CurrentValue?.ToString() ?? "" 
                });
            }
        }

        if (fieldChanges.Count == 0) continue;
        
        AuditEntry audit = new AuditEntry()
        {
            ChangeDate = DateTime.UtcNow,
            EntityType = item.Entity.EntityType,
            EntityName = item.Entity.EntityName,
            UserID = _UserID,
            EntityID = item.Entity.ID,
            Changes = fieldChanges
        };

        audit.ChangeType = item.State switch
        {
            EntityState.Modified => ChangeType.Updated,
            EntityState.Added => ChangeType.Created,
            EntityState.Deleted => ChangeType.Deleted,
            _ => ChangeType.None
        };

        // 直接将审计记录添加到专用DbSet，不通过实体导航属性关联
        auditSet.Add(audit);
    }
}

第四步：显式配置EF Core映射 #

在OnModelCreating方法中明确AuditEntry为独立表，不配置和业务实体的关联关系，阻断EF Core自动生成外键的逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<AuditEntry>(entity =>
    {
        entity.HasKey(e => e.ID);
        // 不配置任何和业务实体关联的HasOne/HasMany关系
        entity.HasMany(e => e.Changes).WithOne().HasForeignKey("AuditEntryID");
        // 添加常用查询字段索引，提升检索效率
        entity.HasIndex(e => new { e.EntityType, e.EntityID });
        entity.HasIndex(e => e.UserID);
        entity.HasIndex(e => e.ChangeDate);
    });

    modelBuilder.Entity<FieldChangeAudit>(entity =>
    {
        entity.HasKey(e => e.ID);
    });

    // ...其余业务实体配置
}

• 完全保留单审计表设计，全局检索效率高：查询指定用户指定时间段的所有变更、某条实体的所有变更记录，都可以直接查询AuditEntry表完成，不需要多表关联
• 审计表结构固定，后续新增需要审计的实体时，不需要修改审计表结构，也不会生成冗余外键列
• 性能更优：不需要EF Core维护大量实体和审计记录的关联跟踪，审计记录可直接批量写入
• 扩展灵活：后续如果需要支持非Guid主键的实体，只需要把EntityID字段改为string类型存储主键字符串值即可，整体架构不需要调整

• 可以在属性遍历逻辑中增加过滤规则，跳过不需要审计的大字段、系统字段
• 对于超长字段值，可以增加截断逻辑，避免超出字段长度限制写入失败
• 如果需要审计操作IP、请求路径等额外信息，直接在AuditEntry类中加对应字段即可，不需要调整核心逻辑

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