分片集合插入报错：需包含分片键且使用简单排序规则

嘿，咱们一步步来解决这个问题～这个报错其实明确说了分片集合的upsert操作必须满足两个核心条件：一是要包含分片键，二是必须使用simple排序规则（collation）。我们逐个排查问题：

1. 先修正分片键与文档字段路径的匹配问题 #

你提供的分片集合创建语句存在语法错误，而且分片键的定义和你插入的文档结构不匹配，这是核心问题之一：

• 正确的shardCollection语法应该是：

  sh.shardCollection("你的数据库名.client", { keyTime: 1, software: 1, name: 1, code: 1 })
  

• 但你插入的文档里，keyTime、software这些字段是嵌套在_id子文档里的，而不是文档的顶级字段。这就导致MongoDB找不到你定义的分片键（因为分片键是顶级字段，而你的字段在_id下面）。

针对这个问题，有两种解决方式：

• 修改分片键为嵌套路径：如果你的业务逻辑必须把这些字段放在_id里，那创建分片集合时要指定嵌套路径作为分片键：

  sh.shardCollection("你的数据库名.client", { "_id.keyTime": 1, "_id.software": 1, "_id.name": 1, "_id.code": 1 })
  

• 调整文档结构：把keyTime、software等字段移到文档顶级，和_id、count同级，这样就能匹配你原本定义的分片键结构。

2. 确保操作使用Simple Collation #

报错里提到的"simple collation"要求，是指你的操作（尤其是upsert场景）必须使用MongoDB默认的简单排序规则。如果你的集合或者当前操作使用了自定义的collation，就会触发这个报错。

• 如果是用updateOne/replaceOne做upsert（这才是报错里提到的upsert场景，单纯的insert如果遇到重复_id只会报重复键错误，不会触发upsert逻辑），需要显式指定simple collation：

  db.client.updateOne(
    { "_id.keyTime": "dfsdf", "_id.software": "kjlkj", "_id.name": "kjljlk", "_id.code": "dsfdfsdf" },
    { $set: { count: NumberLong(17320) } },
    { upsert: true, collation: { locale: "simple" } }
  )
  

• 如果确实是用insert操作，且集合默认collation不是simple，也可以在插入时显式指定：

  db.client.insert(
    { "_id" : { "keyTime" : "dfsdf", "software" : "kjlkj", "name" : "kjljlk", "code" : "dsfdfsdf" }, "count" : NumberLong(17320) },
    { collation: { locale: "simple" } }
  )
  

额外提醒：区分Insert和Upsert的场景 #

你提到用insert语句，但报错里明确提到了"upsert"，这里要注意：单纯的insert如果遇到已存在的_id，只会抛出重复键错误，不会执行upsert逻辑。只有当你使用update/updateOne/replaceOne并设置upsert: true时，才会触发upsert（不存在则插入，存在则更新）的操作。如果你的业务场景确实是需要upsert，一定要用对应的语法，而不是insert。

总结一下，先修正分片键的定义（确保和文档字段路径一致），再确保操作使用simple collation，就能解决这个报错啦～

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