如何在Mongoose的Query Builder中对Populate后的关联文档使用Where子句？

你的问题核心在于对Mongoose populate 机制的理解偏差——populate是在MongoDB返回主集合（Match）的文档后，由Mongoose在客户端层面去关联集合（Game、Player）拉取数据并填充的。这意味着你在find()的where子句中访问game.name时，数据库里的Match文档中game字段只是一个ObjectId，根本不存在name属性，自然会返回空数组。

下面给你两种符合「Query Builder风格」的解决方案：

方案一：先获取目标Game的ID，再筛选Match集合 #

这种方法逻辑直观，代码简洁，完全符合你想要的动态Query Builder需求：

// 第一步：查询所有name为Trackmania的Game文档，只取_id字段
const targetGames = await Game.find()
  .where('name').equals('Trackmania')
  .select('_id');

// 提取ID数组
const gameIds = targetGames.map(game => game._id);

// 第二步：用获取到的Game ID筛选Match，同时populate关联字段
const matchs: Match[] = await Matchs.find()
  .where('game').in(gameIds)
  .populate('game')
  .populate('players')
  .exec();

为什么这种方法可行？ #

我们先从Game集合中拿到符合条件的ID列表，再用这些ID作为Match集合game字段的筛选条件——这是直接对Match集合中实际存在的game字段（ObjectId）进行查询，数据库能正确匹配到结果，之后再通过populate填充完整的关联数据。你可以根据参数动态调整where的条件，完全满足动态定义查询规则的需求。

方案二：用聚合查询（Aggregation）一次性完成关联与筛选 #

如果你的查询逻辑更复杂（比如需要同时结合多个关联集合的字段筛选），可以用MongoDB的聚合框架在数据库层面完成关联和筛选，避免多次查询：

const matchs = await Matchs.aggregate([
  // 关联Game集合，将匹配的Game文档存入game数组
  {
    $lookup: {
      from: 'games', // 注意这里填MongoDB中的集合名称（通常是Model名的小写复数）
      localField: 'game',
      foreignField: '_id',
      as: 'game'
    }
  },
  // 筛选出game数组中第一个元素的name等于Trackmania的文档
  {
    $match: {
      'game.0.name': 'Trackmania'
    }
  },
  // 关联Player集合，将匹配的Player文档存入players数组
  {
    $lookup: {
      from: 'players',
      localField: 'players',
      foreignField: '_id',
      as: 'players'
    }
  },
  // 可选：将game数组转为单个对象（和populate的结果格式一致）
  {
    $addFields: {
      game: { $arrayElemAt: ['$game', 0] }
    }
  }
]);

注意事项 #

• $lookup中的from参数必须是MongoDB实际的集合名称（比如你的Game Model对应的集合通常是games），而不是Mongoose的Model名。
• 聚合查询的返回结果是普通JavaScript对象，不是Mongoose的Document实例，如果需要使用Model的方法，你可以用Matchs.hydrate()把结果转为Document。

关键点总结 #

• 不要混淆「数据库层面的查询」和「客户端层面的填充」：populate是Mongoose在拿到主文档后做的填充操作，不能影响数据库的查询阶段。
• 针对关联字段的筛选，要么先从关联集合拿到目标ID再筛选主集合，要么用聚合查询在数据库层面完成关联筛选。

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