聚合管道本身不支持动态拼接阶段，需在客户端构造完整管道数组后传入aggregate()执行；$match等阶段必须是静态bson结构，服务端不解析js控制流，动态条件须通过客户端逻辑筛选有效字段并安全组装查询对象。
直接说结论：聚合管道本身不支持“动态拼接”阶段，但可以通过客户端逻辑生成完整管道数组，再传给 db.collection.aggregate() 执行——关键在构造阶段数组的时机和方式，而不是在管道里写 if-else。
为什么不能在 $match 阶段里写条件分支
MongoDB 的每个聚合阶段（如 $match、$group）都必须是静态 JSON/BSON 结构，服务端不解析 JavaScript 控制流。你在 shell 或驱动里写的 if (cond) { pipeline.push(...) } 是客户端行为，不是管道语法的一部分。
常见错误现象：
- 在 Compass 或 Atlas 聚合构建器里试图输入
if (x) { $match: {...} }—— 直接报错Invalid stage - 用 Node.js 驱动把未初始化的变量塞进管道，比如
{ $match: req.query.filters || {} }，结果空对象被当成“匹配全部”，查出意外数据
如何安全地动态构造 $match 阶段
核心原则：只往 $match 的查询文档里加有值的字段，避免 { status: null } 或 { name: "" } 这类无效条件污染查询语义。
实操建议：
- 对每个可能的查询参数做显式判断，例如：
if (req.query.status) matchQuery.status = req.query.status - 字符串模糊匹配要包裹正则：用
{ name: { $regex: new RegExp(req.query.name, 'i') } }，别直接拼/${req.query.name}/i（易被注入） - 数值范围需双重校验：
if (req.query.minAmount && !isNaN(req.query.minAmount)) matchQuery.amount = { $gte: Number(req.query.minAmount) } - 多选 ID 列表要用
$in：if (Array.isArray(req.query.ids)) matchQuery._id = { $in: req.query.ids.map(id => new ObjectId(id)) }
多个 $match 阶段可以共存，但没必要硬拆
聚合管道允许重复使用 $match，比如先筛时间范围，再筛状态，再筛关键词。但实际中更推荐合并成一个 $match 阶段——MongoDB 会自动优化单个 $match 内部的布尔逻辑，而多次 $match 会增加文档流转开销。
性能影响明显的情况：
- 集合有千万级文档，且已建复合索引
{ createdAt: 1, status: 1, name: 1 }—— 合并后的$match能命中索引；拆成三个阶段，只有第一个能走索引 - 管道后续有
$lookup—— 提前缩小左表数据量，比后期过滤更省内存
正确示例（Node.js）：
const matchStage = { $match: {} };
if (filters.startDate) matchStage.$match.createdAt = { $gte: new Date(filters.startDate) };
if (filters.status) matchStage.$match.status = filters.status;
if (filters.keyword) {
matchStage.$match.name = { $regex: new RegExp(filters.keyword, 'i') };
}
db.orders.aggregate([matchStage, { $group: { _id: "$status", count: { $sum: 1 } } }]);
复杂条件（如“或关系”）必须手写 $or，不能靠客户端 if
当业务要求“状态是 completed 或 canceled”，不能靠两个 if 分别 push，必须用 $or 显式表达：
错误写法：
if (filters.includeCanceled) pipeline.push({ $match: { status: "canceled" } }); // 覆盖前面的 $match
正确写法：
const orConditions = [];
if (filters.includeCompleted) orConditions.push({ status: "completed" });
if (filters.includeCanceled) orConditions.push({ status: "canceled" });
if (orConditions.length > 0) matchStage.$match.$or = orConditions;
容易被忽略的点：$or 数组为空时，整个 $match 会变成 { $match: { $or: [] } }，这在 MongoDB 中是“永不匹配”，必须提前拦截空数组。
