MongoDB聚合查询：构造含可选条件的$match语句

问题根源 #

直接将非必填条件加入$and数组时，若参数为null，会错误地过滤掉abc_id/xyz_id非null的文档——因为此时条件会变成匹配abc_id: null或xyz_id: {$in: [null]}，不符合「参数不传则不过滤该字段」的需求。

两种可行解决方案 #

方案一：应用层动态生成$match条件（推荐，性能更优）

在业务代码中根据参数是否存在，动态添加过滤条件，避免无效的表达式判断：

// 初始化必选条件
const matchConditions = [
  { is_active: { $eq: true } },
  { is_delete: { $eq: false } }
];

// 仅当abc参数存在（非null/undefined）时，添加abc_id过滤条件
if (abc != null) {
  matchConditions.push({ abc_id: { $eq: abc } });
}

// 仅当xyz参数存在（非null/undefined）时，添加xyz_id过滤条件
if (xyz != null) {
  matchConditions.push({ xyz_id: { $in: [xyz] } });
}

// 生成最终的$match阶段
const matchStage = { $match: { $and: matchConditions } };

方案二：聚合管道内用表达式处理参数（适用于必须在管道内传参的场景）

通过$or结合聚合变量判断参数是否存在，实现「参数为空则跳过该过滤」的逻辑：

{
  "$match": {
    "$expr": {
      "$and": [
        { "$eq": ["$is_active", true] },
        { "$eq": ["$is_delete", false] },
        // 处理abc_id非必填条件
        {
          "$or": [
            { "$eq": ["$$abc", null] }, // 参数为空时条件自动成立
            { "$eq": ["$abc_id", "$$abc"] } // 参数存在时匹配字段值
          ]
        },
        // 处理xyz_id非必填条件
        {
          "$or": [
            { "$eq": ["$$xyz", null] }, // 参数为空时条件自动成立
            { "$in": ["$xyz_id", ["$$xyz"]] } // 参数存在时匹配数组内的值
          ]
        }
      ]
    }
  }
}

执行聚合时需通过let参数传入变量：

db.collection.aggregate([
  // 上述$match阶段
], {
  let: { abc: 传入的abc值, xyz: 传入的xyz值 }
});

核心逻辑说明 #

• 必选条件is_active: true和is_delete: false始终生效，所有结果必须满足这两个条件。
• 非必填条件通过$or实现分支：参数为空时，分支条件直接成立，不对文档做额外过滤；参数存在时，仅保留字段值匹配的文档。

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