Entity Framework唯一键约束冲突：批量添加对象的处理方案咨询

先聊聊你想的这个逐个保存+捕获错误的方案——说实话，它确实能解决问题，但缺点挺明显的，算不上最优解：

• 性能拉胯：每插入一个对象就发起一次数据库请求，列表量大的话，往返次数暴增，速度会慢很多
• 并发风险仍在：就算你逐个处理，还是可能遇到刚检查完没重复，保存时别的线程已经插了相同数据的情况
• 代码冗余：要写一堆try-catch逻辑，代码会变得繁琐难维护

那有啥更靠谱的处理方式呢？给你几个思路：

1. 先在内存中去重，再批量插入 #

如果你的待插入列表里本身就有重复数据（比如生成时不小心重复了），可以先根据唯一约束的字段组合（比如ProductId+PriceDate这类构成唯一键的字段）在内存中去重，再批量提交。

用.NET 6+的DistinctBy会很方便：

// 假设唯一约束是ProductId + PriceDate
var deduplicatedPrices = priceList
    .DistinctBy(p => new { p.ProductId, p.PriceDate })
    .ToList();

context.Prices.AddRange(deduplicatedPrices);
await context.SaveChangesAsync();

不过这个只能解决列表内部的重复，没法处理数据库已有的重复数据，所以最好结合下面的方案。

2. 用EF Core的Upsert（插入或忽略/更新）处理冲突 #

EF Core 5+支持通过Upsert（也就是插入冲突时做忽略或更新操作）来批量处理这类问题，一次数据库请求就能搞定，高效又安全。

比如冲突时直接忽略重复数据：

await context.Prices
    .UpsertRange(priceList)
    // 指定唯一约束的字段组合
    .On(p => new { p.ProductId, p.PriceDate })
    // 遇到冲突时不做任何操作
    .DoNothing()
    .ExecuteAsync();

如果需要在冲突时更新现有数据，把DoNothing()换成DoUpdate()即可：

.DoUpdate(setters => setters
    .SetProperty(p => p.Amount, p => p.Amount)
    .SetProperty(p => p.UpdatedAt, DateTime.Now))

3. 先查询数据库已有数据，过滤后再插入 #

先把数据库中已经存在的符合唯一约束的记录查出来，再从待插入列表中排除这些记录，最后批量插入剩余的新数据：

// 先获取数据库中已有的唯一键组合
var existingKeys = await context.Prices
    .Select(p => new { p.ProductId, p.PriceDate })
    .ToListAsync();

// 过滤出数据库中没有的新数据
var newPrices = priceList
    .Where(p => !existingKeys.Any(ex => ex.ProductId == p.ProductId && ex.PriceDate == p.PriceDate))
    .ToList();

// 批量插入新数据
context.Prices.AddRange(newPrices);
await context.SaveChangesAsync();

这个方案能有效减少冲突概率，但要注意：如果在查询和插入之间，有其他进程插入了相同数据，还是可能触发约束错误。这时候可以在最后加个兜底的try-catch，专门处理唯一约束冲突的异常，比如记录日志后跳过即可。

总结 #

逐个保存的方案属于“能用但不好用”的类型，优先考虑上面的批量处理方案，既提升性能，又能更优雅地处理唯一约束问题。

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