MongoDB C#驱动Bulk Write的UpdateOne Upsert功能异常排查

核心问题原因 #

你遇到的重复键错误，根源是过滤条件与插入时设置的EntryKey大小写不一致：

• 第一次执行时，过滤条件用的是原始的model.EntryKey（假设是大写或混合大小写），找不到文档，触发插入逻辑，此时SetOnInsert把EntryKey转成小写存入数据库。
• 第二次执行时，过滤条件还是用原始的model.EntryKey，依然匹配不到数据库里的小写EntryKey文档，再次触发插入逻辑，尝试插入新的小写EntryKey，但这个值已经存在于唯一索引中，直接抛出重复键错误。
• 而Mongo Shell的操作里，过滤条件和SetOnInsert的EntryKey完全一致，第二次执行时能匹配到已存在的文档，自然走更新逻辑，不会报错。

修复方案 #

1. 统一过滤条件与插入的EntryKey大小写 #

修改过滤条件，同样使用小写的EntryKey，确保每次执行都能匹配到已存在的文档：

// 过滤时也用小写的EntryKey，和插入逻辑保持一致
var filter = filterBuilder.Eq(e => e.EntryKey, model.EntryKey.ToLower());
var update = updateBuilder.Combine(
  updateBuilder.SetOnInsert(e => e._Id, ObjectId.GenerateNewId()),
  // 可选：省略SetOnInsert设置EntryKey，Upsert时会自动从过滤条件带入该字段值
  // updateBuilder.SetOnInsert(e => e.EntryKey, model.EntryKey.ToLower()),
  updateBuilder.Set(e => e.Description, model.Description),
  updateBuilder.Set(e => e.SearchTerm, model.SearchTerm));

var op = new UpdateOneModel<SearchEntry>(filter, update){ IsUpsert = true, Hint = "EntryKey_1" };
bulkList.Add(op);

2. 简化Upsert逻辑（可选） #

当Upsert的过滤条件包含唯一索引字段时，MongoDB会自动将过滤条件中的字段值带入新插入的文档，所以你完全可以省略SetOnInsert(e => e.EntryKey, ...)这一行，进一步避免大小写不一致的风险。

关于Upsert的意义 #

Upsert的核心价值就是原子性的“存在则更新，不存在则插入”，不需要手动拆分查询+更新/插入操作，能避免并发场景下的竞态问题（比如两个线程同时判断文档不存在，然后都执行插入导致重复数据）。你看到的“分开操作”建议，大多针对特殊复杂场景，你的情况完全可以通过修正Upsert逻辑正常使用该功能。

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