如何定位EF Core调用DbContext.SaveChanges触发外键冲突的具体实体

方案1：二分法快速定位冲突实体（无需预先改造逻辑，适合临时排查） #

当外键错误触发时，对当前待提交的变更实体做二分拆分，逐组测试提交定位问题，100条数据最多仅需7次测试即可定位到错误实体，代码示例如下：

try
{
    _context.SaveChanges();
}
catch (DbUpdateException ex) when (ex.InnerException is SqlException sqlEx && sqlEx.Number == 547)
{
    // 外键冲突，定位问题实体
    var faultEntities = LocateFaultEntities(_context).ToList();
    // 此处可打印问题实体的主键、外键值等信息用于排查
    throw;
}

// 递归定位问题实体
private IEnumerable<object> LocateFaultEntities(DbContext context)
{
    var entries = context.ChangeTracker.Entries()
        .Where(e => e.State == EntityState.Added || e.State == EntityState.Modified)
        .ToList();
    if (entries.Count == 1)
    {
        yield return entries[0].Entity;
        yield break;
    }
    // 拆分分组
    var half = entries.Count / 2;
    var group1 = entries.Take(half).ToList();
    var group2 = entries.Skip(half).ToList();
    if (TestGroupHasError(context, group1))
    {
        foreach (var entity in LocateFaultEntities(context)) yield return entity;
    }
    if (TestGroupHasError(context, group2))
    {
        foreach (var entity in LocateFaultEntities(context)) yield return entity;
    }
}

// 测试指定分组是否存在外键错误
private bool TestGroupHasError(DbContext context, List<EntityEntry> testEntries)
{
    var allEntries = context.ChangeTracker.Entries().ToList();
    // 临时关闭非测试分组的实体变更
    foreach (var entry in allEntries)
    {
        if (!testEntries.Contains(entry)) entry.State = EntityState.Unchanged;
    }
    try
    {
        context.SaveChanges();
        return false;
    }
    catch (DbUpdateException ex) when (ex.InnerException is SqlException sqlEx && sqlEx.Number == 547)
    {
        return true;
    }
    finally
    {
        // 恢复所有实体的原始状态
        foreach (var entry in allEntries)
        {
            entry.State = entry.OriginalState;
        }
    }
}

该方案不会修改原有业务逻辑，定位效率高，仅适合错误发生后的临时排查使用。

方案2：外键预校验（提交前提前识别问题，适合常态化使用） #

默认的Validator仅会校验数据注解规则，不会校验外键关联数据的合法性，你可以扩展DbContext实现外键的预校验，无需等待数据库报错即可识别问题实体，代码示例如下：

public static Dictionary<object, List<string>> ValidateForeignKeys(this DbContext context)
{
    var errors = new Dictionary<object, List<string>>();
    var entries = context.ChangeTracker.Entries()
        .Where(e => e.State == EntityState.Added || e.State == EntityState.Modified)
        .ToList();
    foreach (var entry in entries)
    {
        // 获取当前实体的所有外键配置
        var foreignKeys = entry.Metadata.GetForeignKeys();
        foreach (var fk in foreignKeys)
        {
            // 获取外键属性值
            var fkValues = fk.Properties.Select(p => entry.Property(p.Name).CurrentValue).ToList();
            // 跳过允许为空且全为null的外键
            if (fkValues.All(v => v == null)) continue;
            // 查询关联表是否存在对应主键记录
            var principalSet = context.Set(fk.PrincipalEntityType.ClrType);
            var pkProperties = fk.PrincipalKey.Properties;
            IQueryable query = principalSet;
            for (int i = 0; i < pkProperties.Count; i++)
            {
                query = query.Where($"{pkProperties[i].Name} == @0", fkValues[i]);
            }
            if (!query.Any())
            {
                if (!errors.ContainsKey(entry.Entity))
                {
                    errors[entry.Entity] = new List<string>();
                }
                var fkPropNames = string.Join(",", fk.Properties.Select(p => p.Name));
                var principalName = fk.PrincipalEntityType.ClrType.Name;
                var pkValues = string.Join(",", fkValues);
                errors[entry.Entity].Add($"外键冲突：属性[{fkPropNames}]关联的[{principalName}]表不存在主键为[{pkValues}]的记录");
            }
        }
    }
    return errors;
}

使用时在调用SaveChanges前执行该方法即可直接获取所有外键异常的实体和对应的错误详情，适合需要常态化校验外键的业务场景。

方案3：升级EF Core版本（长期最优解） #

EF Core 2.2存在DbUpdateException.Entries捕获不全的已知问题，升级到EF Core 3.0及以上版本后，SQL Server外键错误场景下Entries属性会正确返回关联的错误实体，无需额外编写定位逻辑。

内容的提问来源于stack exchange，提问作者Дмитро Кононенко