如何使用Mongoose aggregate跨集合匹配字段过滤排除指定文档

你要实现的逻辑本质是：筛选active: true的目标集合文档，排除掉关联字段值和另一集合中指定userId文档关联字段值相等的条目，用单次聚合即可完成，不需要分两次全量查询再做内存过滤。

聚合实现代码（推荐，大数据量场景性能更好） #

const userId = "23523891729417419";
const result = await Students.aggregate([
  // 前置过滤当前集合的有效文档，减少后续关联计算的数据量
  { $match: { active: true } },
  // 左连接关联Courses集合，仅匹配符合userId条件、且关联字段值相等的文档
  {
    $lookup: {
      from: "courses", // 替换为Courses模型对应的MongoDB实际集合名
      let: { matchField: "$someOtherId" },
      pipeline: [
        {
          $match: {
            $expr: {
              $and: [
                { $eq: ["$userId", userId] },
                { $eq: ["$someId", "$$matchField"] }
              ]
            }
          }
        }
      ],
      as: "matchedRelations"
    }
  },
  // 仅保留没有匹配到关联文档的条目
  { $match: { "matchedRelations.0": { $exists: false } } },
  // 可选：移除结果中多余的关联字段
  { $project: { matchedRelations: 0 } }
]);

简化实现（适合关联集合数据量小的场景） #

如果指定userId关联的课程文档量不大，也可以不用聚合，分两次查询用$nin过滤，逻辑更直观：

const userId = "23523891729417419";
// 仅查询需要的关联字段，减少数据传输
const matchedIds = (await Courses.find({ userId }, { someId: 1, _id: 0 })).map(i => i.someId);
// 直接查询排除匹配项的学生文档
const result = await Students.find({
  active: true,
  someOtherId: { $nin: matchedIds }
});

注意事项 #

• $lookup的from参数必须填MongoDB中存储的真实集合名，默认Mongoose会把模型名转成小写复数作为集合名，如果你定义模型时手动指定了collection参数，要替换成对应值。
• 聚合写法所有过滤、匹配逻辑都在数据库层面完成，不会把两个集合的全量数据加载到Node.js内存，数据量越大性能优势越明显。
• 简化写法中如果单用户关联的课程数据超过1000条，不建议使用，避免$nin传入的数组过长触发MongoDB查询参数长度限制、影响查询性能。

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