Mongoose如何基于数组字段值实现lookup关联查询并过滤结果

前置优化：明确Schema字段类型 #

首先建议你先完善teamSchema中coaches字段的类型定义，避免后续类型不匹配导致关联失败：

userSchema = new mongoose.Schema({
    name: {
        type: String, 
        required: true
        },
    team: {
        type: Schema.Types.ObjectId, ref: 'Team',required:true
        }
})

teamSchema = new mongoose.Schema({
    name: {
        type: String, 
        required: true
    },
    // 明确coaches为用户ObjectId数组，关联User模型
    coaches: [{
        type: Schema.Types.ObjectId,
        ref: 'User'
    }]
})

方案1：使用populate实现（简单场景推荐） #

优化Schema后，普通查询直接用populate即可满足需求：

场景：筛选coaches包含指定用户ID的团队，同时带出所有教练的完整用户信息 #

const targetUserId = mongoose.Types.ObjectId("你要查询的指定用户ID");
const teams = await Team.find({
  coaches: targetUserId
}).populate('coaches'); // 自动关联User集合填充coaches字段

场景：查询指定用户作为教练关联的所有团队，同时带出用户自身所属团队信息 #

const targetUserId = mongoose.Types.ObjectId("你要查询的指定用户ID");
const userInfo = await User.findById(targetUserId).populate('team');
const coachTeams = await Team.find({ coaches: targetUserId });
// 合并结果即可得到带关联信息的完整数据

方案2：使用$lookup聚合实现（复杂查询场景适用） #

如果需要在聚合流程中完成关联，使用如下写法：

场景：筛选coaches包含指定用户ID的团队，同时关联填充用户信息 #

const targetUserId = mongoose.Types.ObjectId("你要查询的指定用户ID");
const result = await Team.aggregate([
  // 第一步：筛选符合条件的团队
  {
    $match: {
      coaches: targetUserId
    }
  },
  // 第二步：关联User集合填充coaches字段
  {
    $lookup: {
      from: "users", // User模型对应MongoDB中的集合名，默认是模型名小写加s
      localField: "coaches",
      foreignField: "_id",
      as: "coaches"
    }
  }
])

场景：查询指定用户信息，同时关联带出其作为教练的所有团队 #

const targetUserId = mongoose.Types.ObjectId("你要查询的指定用户ID");
const result = await User.aggregate([
  {
    $match: { _id: targetUserId }
  },
  // 关联用户所属团队
  {
    $lookup: {
      from: "teams",
      localField: "team",
      foreignField: "_id",
      as: "belongTeam"
    }
  },
  // 关联用户作为教练的团队
  {
    $lookup: {
      from: "teams",
      let: { userId: "$_id" },
      pipeline: [
        {
          $match: {
            $expr: { $in: ["$$userId", "$coaches"] }
          }
        }
      ],
      as: "coachTeams"
    }
  }
])

如果你当前coaches数组中存储的是字符串格式的用户ID，而非ObjectId，只需要把上述代码中mongoose.Types.ObjectId()转换步骤去掉，直接传入字符串ID即可，不过还是建议统一存储为ObjectId格式避免后续关联异常。

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