Entity Framework中SaveChanges遇部分失败时如何保存其余数据？

方法1：逐个处理实体，捕获冲突异常 #

循环遍历每个实体，单独执行添加和保存操作，捕获主键冲突相关的异常，跳过失败的实体继续处理下一个。这种方式逻辑简单，适合数据量不大的场景：

foreach (var entity in data)
{
    try
    {
        dbContext.EntityX.Add(entity);
        await dbContext.SaveChangesAsync();
        // 保存成功可记录日志或执行其他后续操作
    }
    catch (DbUpdateException ex)
    {
        // 根据数据库类型判断是否为主键冲突
        // 示例：SQL Server主键冲突错误码为2627，MySQL为1062
        if (ex.InnerException is SqlException sqlEx && sqlEx.Number == 2627)
        {
            // 移除当前实体，避免影响后续操作
            dbContext.Entry(entity).State = EntityState.Detached;
            // 可记录冲突日志，比如"主键 {entity.Id} 已存在，跳过保存"
        }
        else
        {
            // 非主键冲突的异常，重新抛出
            throw;
        }
    }
}

方法2：提前过滤冲突实体 #

先查询数据库中已存在的主键，过滤掉列表中重复的实体，再批量添加剩余的。这种方式性能更优，减少了数据库交互次数：

// 提取待添加实体的主键集合
var incomingIds = data.Select(e => e.Id).ToList();
// 查询数据库中已存在的主键
var existingIds = await dbContext.EntityX
    .Where(e => incomingIds.Contains(e.Id))
    .Select(e => e.Id)
    .ToListAsync();
// 过滤掉冲突的实体
var validEntities = data.Where(e => !existingIds.Contains(e.Id)).ToList();

// 批量添加并保存
if (validEntities.Any())
{
    await dbContext.EntityX.AddRangeAsync(validEntities);
    await dbContext.SaveChangesAsync();
}

这种方法的优势是仅需两次数据库操作（一次查询、一次批量保存），适合数据量大的场景，但要注意主键查询的性能——如果主键是索引列，效率会很高；如果数据量极大，建议分批次查询。

额外提示 #

• 若使用EF Core 7+，可考虑Upsert逻辑（更新已存在的实体），但如果需求是跳过冲突而非更新，上述两种方法更贴合需求。
• 无论采用哪种方案，都建议添加日志记录，跟踪保存失败的实体及原因，方便后续排查问题。

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