如何在MongoDB中向嵌套文档的players数组插入对象

前置说明 #

你需要操作的是三层嵌套的数组结构：rounds → matches → players，推荐用带arrayFilters的更新方式，避免硬编码数组下标导致的逻辑错误。 #

场景1：精准插入到指定轮次、指定场次的players数组 #

假设你需要往第1轮、第1场的players数组插入如下玩家对象：

{
  "userId": "123456",
  "nickname": "玩家A",
  "score": 0
}

执行的MongoDB语句如下：

db.collection.updateOne(
  // 过滤条件：定位到指定锦标赛文档
  {
    "data.createTournament._id": ObjectId("6130d9a565aa744f173a824a")
  },
  // 更新操作：往目标players数组追加对象
  {
    $push: {
      "data.createTournament.rounds.$[round].matches.$[match].players": {
        "userId": "123456",
        "nickname": "玩家A",
        "score": 0
      }
    }
  },
  // 数组过滤器：定位嵌套数组中符合条件的元素
  {
    arrayFilters: [
      { "round.round": 1 },
      { "match.match": 1 }
    ]
  }
)

注：如果你的文档中_id是以字符串类型存储的，过滤条件里去掉ObjectId()包裹直接写字符串即可

如果需要一次性插入多个玩家，可以搭配$each修饰符：

db.collection.updateOne(
  { "data.createTournament._id": ObjectId("6130d9a565aa744f173a824a") },
  {
    $push: {
      "data.createTournament.rounds.$[round].matches.$[match].players": {
        $each: [
          {"userId": "123456", "nickname": "玩家A", "score": 0},
          {"userId": "789012", "nickname": "玩家B", "score": 0}
        ]
      }
    }
  },
  { arrayFilters: [{"round.round":1}, {"match.match":1}] }
)

场景2：简化写法（仅适用于固定下标的场景） #

如果你能确定目标players的数组下标固定（比如当前只有1轮1场，对应下标都是0），可以直接硬编码下标，写法更简单：

db.collection.updateOne(
  { "data.createTournament._id": ObjectId("6130d9a565aa744f173a824a") },
  {
    $push: {
      "data.createTournament.rounds.0.matches.0.players": {
        "userId": "123456",
        "nickname": "玩家A",
        "score": 0
      }
    }
  }
)

补充说明 #

如果需要避免插入重复的玩家数据，可以将$push替换为$addToSet，只要插入的玩家对象完全一致就会自动去重；如果要根据玩家唯一ID去重，可以额外搭配$ne过滤条件实现。

内容的提问来源于stack exchange，提问作者Daywison Ferreira Leal