MongoDB分片集群执行Upsert失败：无法提取精确分片键问题排查

错误含义解析 #

Failed to target upsert by query :: could not extract exact shard key 这个错误的核心是：MongoDB执行upsert（更新或插入）操作时，当没有匹配到现有文档需要插入新文档时，无法从查询条件或更新语句中确定唯一、明确的分片键值，导致无法确定新文档应该路由到哪个分片。

具体问题分析 #

1. 分片键不可修改 #

你第一个update语句试图修改分片键itemId的值（从"a2"改为"a3"），这在MongoDB分片集群中是绝对不允许的：
分片键的作用是决定文档存储的分片，修改分片键值意味着文档需要跨分片移动，MongoDB 5.0默认不支持修改分片键字段，即使后续版本支持也不推荐这种操作，会严重影响集群性能。

2. 语法错误导致分片键提取失败 #

你提供的两个update语句都存在语法错误：updateOne方法仅接受3个参数（查询条件、更新文档、选项对象），但你传入了4个参数（把{upsert: true}和{multi: false}拆成了两个独立对象）。这种语法错误会导致MongoDB无法正确解析选项参数，进而无法从查询条件中正确提取分片键，最终触发报错。

3. Upsert的分片键硬性要求 #

即使修正语法，执行upsert时还需满足：

• 查询条件必须包含分片键的精确匹配（不能使用$in、$gt等范围操作符），你这里的itemId: "a2"符合要求。
• 插入新文档时，分片键的值必须明确（要么来自查询条件，要么在更新语句的$set中指定，且不能冲突）。

修正后的示例代码 #

正确的非分片键更新（带upsert） #

db.MyCollection.updateOne(
  {"_id": "a2", "itemId": "a2"}, 
  {"$set": {"itemColor": "brown"}}, 
  {upsert: true} // 所有选项合并到一个对象中
)

分片键变更的正确方式 #

如果需要变更itemId的值，不要直接更新，正确流程是：

1. 删除原文档
2. 插入带有新itemId值的新文档

额外检查点 #

• 确认itemId字段的唯一索引已正确创建，且作为分片键的配置无误。
• 确保Reactive Spring Data代码中，查询条件正确包含分片键的精确匹配，且驱动方法调用的参数格式正确。

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