本文介绍如何在 MongoDB 聚合查询中，基于父文档（如 workspace）内存储的 ObjectId 数组（如 workbooks），动态关联并排除 isArchived: true 的子文档，最终返回仅含有效 workbook ID 的精简结果。
本文介绍如何在 mongodb 聚合查询中，基于父文档（如 workspace）内存储的 objectid 数组（如 workbooks），动态关联并排除 `isarchived: true` 的子文档，最终返回仅含有效 workbook id 的精简结果。
在实际业务场景中，常需通过父集合（如 workspace）中的 ObjectId 数组字段（如 workbooks）关联子集合（如 workbooks），但又要求按子文档状态（如 isArchived）进行条件过滤——这不能靠简单 $lookup 完成，必须结合聚合管道的 $filter 和 $set 阶段实现精准裁剪。
✅ 核心解决方案：聚合管道 + $lookup + $filter
以下聚合查询可精确满足需求：查找指定 workspace，并只保留其 workbooks 数组中 isArchived !== true 的条目（即 false 或缺失该字段的文档）：
db.workspace.aggregate([
{
$match: { _id: ObjectId("650152787b7376a6fc4b1f76") }
},
{
$lookup: {
from: "workbooks",
localField: "workbooks", // workspace.workbooks 是 ObjectId 数组
foreignField: "_id", // 关联 workbooks._id
as: "workbooks" // 覆盖原数组，注入完整子文档
}
},
{
$set: {
workbooks: {
$filter: {
input: "$workbooks",
as: "wb",
cond: { $ne: ["$$wb.isArchived", true] }
}
}
}
}
])
? 关键点说明：
- $lookup 将 workspace.workbooks 中每个 ObjectId 替换为对应 workbooks 文档的完整对象；
- $filter 遍历关联后的 workbooks 数组，仅保留 isArchived 字段值 不等于 true 的项（自动兼容 null、undefined、false 等非真值）；
- $set 安全覆盖原 workbooks 字段，无需重写所有字段，语义清晰且性能友好。
? 使用 Mongoose 的等效实现（推荐生产环境）
若项目使用 Mongoose，可借助 populate() 的 match 选项，在查询时直接过滤关联数据，更简洁高效：
const workspaces = await WorkspaceModel.find({ _id: "650152787b7376a6fc4b1f76" })
.populate({
path: "workbooks",
model: "Workbook", // 或 WorkbookModel
match: { isArchived: { $ne: true } }, // 关键：服务端过滤
select: "_id title description properties isActive" // 可选：精简返回字段
});
✅ 优势：
- 自动处理 ObjectId 转换与关联；
- match 在 $lookup 阶段生效，避免内存中过滤，减少网络传输和内存开销；
- 支持链式 select() 控制返回字段粒度。
⚠️ 注意事项：
- 若 workbooks 字段存储的是原始字符串（非 ObjectId 对象），需先用 $toObjectId 转换，或确保 Schema 中定义为 ref 类型；
- match: { isArchived: { $ne: true } } 等价于 { isArchived: { $in: [null, false, undefined] } }，但更简洁鲁棒；
- 如需返回仅 _id（类似原始数组结构），可添加 select: "_id"，此时 workbooks 字段将变为 ObjectId 对象数组而非文档对象。
✅ 总结
过滤嵌套引用数组的核心逻辑是：先关联（$lookup），再筛选（$filter 或 populate.match），最后投影（select）。聚合方案适合复杂定制化场景；Mongoose populate + match 则更适合标准 ORM 开发，兼顾可读性与执行效率。无论哪种方式，都应避免在应用层遍历过滤，以充分发挥数据库的查询优化能力。
