如何在Mongoose的findOneAndUpdate中使用复合对象作为_id筛选条件

1. 首先修正Schema定义 #

Mongoose默认会自动为所有文档生成ObjectId类型的_id字段，你使用复合结构作为_id需要显式定义_id的结构，同时关闭默认_id生成逻辑：

const scorecardSchema = new mongoose.Schema({
  // 显式定义复合_id的结构
  _id: {
    playerId: String, // 类型和你实际存储的保持一致，是Number就改Number
    tournamentId: String
  },
  playerName: String,
  score: [{
    _id: mongoose.Types.ObjectId // 这里的类型和你传入的matchID类型保持一致
  }]
}, { _id: false }); // 关键配置：禁用Mongoose自动生成默认_id的行为

const Scorecard = mongoose.model('Scorecard', scorecardSchema);

2. 推荐使用点路径写法编写查询条件 #

MongoDB匹配完整嵌套对象时会严格校验字段顺序，顺序不匹配会直接判定为查询失败，使用点路径匹配嵌套字段可以规避这个问题，稳定性更高：

await Scorecard.findOneAndUpdate(
  // 点路径查询，不依赖字段顺序
  {
    "_id.playerId": playerId,
    "_id.tournamentId": tournamentId
  },
  {
    $addToSet: {
      score: { _id: matchID }
    }
  },
  // 可选配置，根据业务需求开启
  {
    new: true, // 返回更新后的文档，默认返回更新前的旧文档
    // upsert: true 匹配不到文档时自动插入新文档
  }
);

3. 若坚持使用完整对象匹配_id的写法 #

必须严格保证查询时_id内的字段顺序和文档存储、Schema定义的顺序完全一致，同时保证playerId、tournamentId的类型和Schema定义完全匹配（比如Schema定义为Number就不能传String类型的值）：

await Scorecard.findOneAndUpdate(
  {
    _id: {
      playerId: playerId, // 顺序不能调换，必须和文档存储顺序一致
      tournamentId: tournamentId
    }
  },
  {
    $addToSet: {
      score: { _id: matchID }
    }
  }
);

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