使用Audit.NET时出现AuditQuantitativeResearch.AuditId外键变更报错

问题原因 #

该问题是多重因素叠加触发，且仅在生产大数据量插入场景下显现，核心原因如下：

• 审计表主键配置缺失：AuditQuantitativeResearch的主键AuditId未添加[DatabaseGenerated(DatabaseGeneratedOption.Identity)]自增标记，EF Core默认认为主键值需要手动提供，插入审计记录时会先赋值默认值0，数据库生成自增ID后Change Tracker检测到主键值变化，误判为外键变更。
• 错误的实体关系配置：大概率在DbContext的OnModelCreating中不小心给AuditQuantitativeResearch配置了指向主表QuantitativeResearch的外键关联，且错误将AuditId作为外键字段，触发EF Core的外键变更校验。
• 仓储方法写法缺陷：AddAsync方法重复标记实体新增状态，且异步方法中混用同步SaveChanges，批量插入场景下DbContext跟踪实体过多时会出现状态混乱，开发环境插入数据量少不会触发，生产环境长流程大数据量就会暴露问题。

解决办法 #

1. 补全审计表主键自增配置
   确认生产数据库AuditQuantitativeResearch表的AuditId字段为IDENTITY自增，同时更新代码配置：

public class AuditQuantitativeResearch : IAudit
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)] // 新增自增标记
    public long AuditId { get; set; }

    public long ID { get; set; }
}

2. 删除审计表与主表的错误外键关联
   检查DbContext的OnModelCreating方法，删除所有针对审计表的导航属性、外键关联配置，审计表不需要和主表做EF层面的关联。
3. 修正仓储方法的错误写法
   删除重复的状态设置，统一使用异步操作：

public async Task<T> AddAsync(T entity)
{
    _log.LogDebug($"[{nameof(T)}] 新增记录");
    try
    {
        await _db.Set<T>().AddAsync(entity);
        await _db.SaveChangesAsync();
    }
    catch (Exception ex)
    {
        _log.LogError(ex, "新增记录失败");
        throw;
    }
    return entity;
}

4. 批量插入场景优化
   Excel导入长流程中，每处理100~200条数据就释放重建一次DbContext，避免ChangeTracker跟踪实体过多导致状态混乱。
5. 临时开启敏感日志排查
   如果问题仍未解决，可临时开启EF Core敏感数据日志，获取AuditId变更前后的具体值快速定位：

services.AddDbContext<YourDbContext>(options =>
    options.UseSqlServer(connString)
           .EnableSensitiveDataLogging()
);

排查完成后及时关闭敏感日志避免数据泄露。

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